MoodleDocs - User contributions [en]

Upload users

2020-06-30T17:07:49Z

Krause: /* Optional user fields */

{{Accounts}}
==Uploading users via text file==

There are many options for uploading information (fields associated with a user) with this method: from enrolling users in multiple courses with course specific [[Roles|roles]] to updating user information in the [[User profile]] to deleting users from the site.

''Tip:'' It is usually not necessary to upload users in bulk with Upload users. To keep maintenance work down you should first explore forms of authentication that do not require manual maintenance, such as [[External database authentication|connecting to existing external databases]] or letting the users create their own accounts ([[Self enrolment]]). See [[Authentication]] for more information.

{{MediaPlayer | url = https://youtu.be/blUw-ZbhFqw| desc = How to bulk upload users and add to courses}}

==File formats for upload users file==
The upload users file has fields separated by a comma (or other delimiter) ONLY - no space. The first line contains the valid field names. The rest of the lines (records) contain information about each user.

''Tip:'' Avoid special characters in field information like quotes or other commas. Test a file with only one record before a large upload.

''Tip:'' You can use a spread sheet program to create the file with the required columns and fields. Then save the file as "CSV (comma delimited)". These files can be opened with simple text editors (eg, [https://notepad-plus-plus.org/ Notepad++]) for verification.

===Valid upload file for testing===

*From Site administration / Users / Upload users, an example text (.csv) file is available. It includes can be downloaded and adapted to your needs.

username,firstname,lastname,email

student1,Student,One,s1@example.com

student2,Student,Two,s2@example.com

student3,Student,Three,s3@example.com

*Additional fields can be added as below. The course and cohort must already have been manually created.

username,firstname,lastname,email,course1,group1,cohort1

student1,Student,One,s1@example.com,math102,groupA,cohortZ

student2,Student,Two,s2@example.com,math102,groupB,cohort Y

student3,Student,Three,s3@example.com,math102,groupA,cohortZ

== User Fields that can be included==

''Tip:'' We strongly recommend that you test a file that contains fields you proposed to use with one user before attempting a file upload for the first time.

===Required fields===

These are the required user identification fields:
<code>username,firstname,lastname,email</code>
Validity checks are performed for:
* '''username''' can only contain alphabetical '''lowercase''' letters , numbers, hypen '-', underscore '_', period '.', or at-sign '@'
* '''email''' is in the form: ''name@example.com''

===Passwords===

The "password" field is optional if the 'New user password' setting on the upload screen is set to "Create password if needed and send via email" but is required if the setting is "Field required in file".

If included, values should meet the requirements for the site's [[Site_policies#Password_policy|Password policy]].

To force password change for a particular user, set the password field to '''changeme'''. If omitted, a password will be generated for each user (during the next Cron job) and welcome e-mails sent out. The text for the welcome e-mail is in the language settings in ''Site administration > Language > Language customisation'' with a String identifier of 'newusernewpasswordtext'.

===Optional user fields===

Note: Commas within a field must be encoded as &#44 - the script will decode these back to commas.
Tip: For Boolean fields with only two values, use '''0''' for false and '''1'''for true.

To provide values other than the default you can include one or more of these optional user fields:

<pre>institution,department,city,country,lang,auth,timezone,idnumber,icq,phone1,phone2,address,url,description,mailformat,maildisplay,maildigest,htmleditor,autosubscribe,interests,theme</pre>

Most of the these are user profile fields or user preference fields that belong to the user profile and are the filled in the user or at manual creation. Some however require specific formats:

See [[Additional name fields]] for more details. Key things to note are:

'''country''' - use the country TWO LETTER CODE, in upper case, eg AU,ES,GB,US. These are all UPPER CASE. Using "au" or "es" or "USA" as a country code will result in a database error. If you are having trouble working out the two-letter code for a country, you can consult the list of [https://www.iso.org/obp/ui/#search country names and code elements] available on the ISO Website. A common error is to use UK for United Kingdom; it should be GB.

'''lang''' - use the two letter (or extended four lettter) code as defined in the Moodle language packs, e.g. en, es, en_us, de, in ''Site administration > Language > Language packs''.

'''auth''' - The auth field must be used if the site uses an alternative authentication method, such as LDAP, as otherwise the authentication method will default to manual and users using a different auth method won't be able to log in.
Use the shortname codes defined in Plugins > Authentication for the various types, e.g. manual, nlogin, ldap, cas, mnet, db, none. If you do not include an auth column, then newly created users will be created with the manual account type.

You can set "auth" to "nologin" in your csv file which will mean that then created users cannot login.

'''timezone''' - Should be in the format as found in the Location settings in terms of Zone/Region, eg. Australia/Sydney, Asia/Kathmandu, Europe/Madrid, etc. The entry is case sensitive so Europe/London will work but europe/london will not.

NOTE: Needed: settings for '''mailformat''','''maildisplay''','''htmleditor''','''autosubscribe'''

'''maildigest''' To prevent users from receiving a large number of emails from courses or forced subscription forums use the '''maildigest'''. The options for this field are 0 = No digest, 1 = Complete digest and 2 = Digest with just subjects.

'''maildisplay''' allows you to set the email display option for a user. The options for this field are 0 = Hide my email address from non-privileged users, 1 = Allow everyone to see my email address and 2 = Allow only other course members to see my email address.

'''theme''' User themes may be added by using 'classic', 'boost' or the name of any other installed theme. The value should be the short name of the theme, e.g 'boost' not 'Boost', 'fordson' not 'Fordson'.

===Custom profile field names===

These are optional and depend on whether you have created any custom profile fields in your site. The name of the header in file is of the form 'profile_field_xxxxx' where xxxx is the unique shortname of custom user profile field name as you created it.

The field name should match the case of the profile field shortname. So, for instance if the shortname of your custom profile field is all upper case, for example, ''DOB'', then use a header of ''profile_field_DOB'' to match the case, not ''profile_field_dob'', which will produce a "is not a valid field name" error. Likewise, a mixed case shortname such as ''Dob'' should have a header of ''profile_field_Dob''. (The exception to this is if the shortname is all lower case, then any case will work in the field header, which is a historical quirk: but best practice is to match the case and you will avoid errors.)

<pre>profile_field_xxxxx</pre>

'''Example''': To create a custom field "genre", you must write a shortname "genre" in the new field, and write "profile_field_genre" in the header of the .csv file.

For custom profile fields that are dates, use the ISO standard format YYYY-MM-DD, eg. 2014-06-19 which will then be properly localized in the interfaced. For example, a field called dohire for date of hire, the fields could be:
<pre>
username,firstname,lastname,email,profile_field_dohire
blumbergh,Bill,Lumbergh,blumbergh@example.com,1990-02-19
pgibbons,Peter,BGibbons,pgibbons@example.com,1996-06-05
tsmykowski,Tom,Smykowski,tsmykowski@example.com,1970-01-01
</pre>

For custom profile fields that are a menu, use the corresponding value in the menu list from field as you defined it. For example: a custom field 'corporatedivision' with one of three values 'Management', 'Development' or 'Training'. Just insert one of those three words (e.g. 'Training') as the value for that field. Eg.

<pre>
username,firstname,lastname,email,profile_field_corporatedivision
blumbergh,Bill,Lumbergh,blumbergh@example.com,Management
pgibbons,Peter,BGibbons,pgibbons@example.com,Development
tsmykowski,Tom,Smykowski,tsmykowski@example.com,Training
</pre>

=== Special user change fields===

Three special fields are used for managing user accounts, '''oldusername''', '''deleted''' and '''suspended'''. [[#Allow_renames|See below for details]].

===Enrolment fields===

You may optionally enrol users in already existing courses using manual enrolment. Only manual enrolment is done this way; if the manual enrolment method is disabled in a course, then no enrol is done.

You use fields in the upload file of this type:

<pre>course1,type1,role1,group1,enroltimestart1,enrolperiod1,enrolstatus1,course2,type2,role2,group2,enroltimestart2,enrolperiod2,enrolstatus2</pre> etc.

Header fields '''must''' have a numeric suffix such that type1,role1,group1,enrolperiod1 and enrolstatus1 all apply to course1 for course'''1''' to course'''n'''. Even if you are just doing one course enrolment, you must still use the number 1 on the heading name, i.e. course1,role1, etc. Do not use the bare headings without numbers, e.g. course,role, etc as those will generate an error.

'''course#''' is the shortname of the course, if present the user will be enrolled in that course. Do not use the fullname of the course or it will generate an error. This field is the ONLY required field for a succesful enrolment. All the others are optional.

'''type#''' sets the role to be used for the enrolment. A value of 1 is default course role, 2 is legacy Teacher role and 3 is legacy Non-editing Teacher.

'''role#''' may be used to specify roles directly, using either role short name or the role id (numeric names of roles are not supported). Usually you will use the role name that is the shortname of the role as defined in Users > Permissions > Define roles, eg. student, editingteacher. If the role column is left out, the users will be enroled in the course with the default role, which is normally student.

'''group#''' may be used to assign users to groups in course, using name or id (numeric group names are not supported). NOTE: if the group does not already exist, it will be created.

'''enroltimestart#''' may be used to set the enrolment start time, for each course. If not explicitly set here, the enrolment start time is set to be today.

'''enrolperiod#''' may be used to set the enrolment duration, in days, for each course. If not explicitly set here, all the users will get the duration as set in the Manual enrolment method of the course (which defaults to 0 meaning unlimited.)

'''enrolstatus#''' is optional as by default all newly enrolled users are set to active. If used a value of 1, it will suspend users in the course and if a user is previously set as inactive / suspended then a value of 0 will unsuspend them and make them active again.

=== Cohort membership assignment===

You can assign users to any already existing Cohort by using only the "username" and the "Cohort ID" with just two fields in the file. Note that this is an exception to the usual case where the firstname, lastname and email address of the user are required.

'''cohort#''' is the form to use and like enrolment in courses, you have to add a number to each header, so cohort1,cohort2, etc.

Internal cohort id numbers or non-numeric Cohort IDs of existing cohorts must be used; do not use the full name are not allowed. (Note that cohort id is what is usually known elsewhere as the "shortname".)

Here is a sample CSV file:

<pre>
username,cohort1,cohort2
student1,nursing,2016class
student2,nursing,2014class
student3,nursing,2014class
</pre>

=== MNet ===

Existing [[MNet]]users can be added to courses, groups or cohorts as below by using the field header '''mnethostid'''

#enrolling to courses: username+mnethostid+course required
#adding to group: username+mnethostid+course+group required
#adding to cohort: username+mnethostid+cohort required
#suspending/reviving accounts: username+mnethostid+suspended required

All other operations are ignored. You can not add users, delete them or update them (such as change names or email, profile fields, etc.)

=== Set system roles ===
Users may also be assigned to already defined system roles, using the shortname of the system role as defined in ''Site administration > Users > Permissions > Define roles'' for roles with a system context defined.

<code>sysrole1,sysrole2,sysrole3</code> etc

Users may be uploaded to a system role (usually Manager or Course creator) by entering the shortname of that role. Other roles can only be uploaded if they have already been assigned in the 'system' context. See [[Creating custom roles]]. Multiple roles can be assigned using sysrole2, sysrole3, etc. fields. Note that the number suffix in no way relates to the number suffixes on the enrolment fields. The numbers must go up in sequence starting at 1.

Unassigning system roles
Users can also be removed from a given system role by entering the shortname of that role prefixed with a minus symbol: '-'. If the user is currently assigned to that role, they are removed from it. If the user is not currently assigned to that system role, the field value is ignored. However, the field value must refer to a system role that does exist on the system, otherwise an error will occur.
[[File:GlobalRoles1.png|thumb|500px|center|Example of a file for uploading users with global/system roles]]

==Upload user process==

# Create file for uploading
# Go to ''Site administration > Users > Accounts > Upload users''
# Add file to upload
# Upload users preview - check settings and default user profile settings
# Upload users preview - click "Upload users"
# Upload users results - shows list of users, exceptions made in upload and summary of number of users
# Upload users results - click "Continue"
# Returns to Upload users screen

==Updating users preview==
There are various settings to better control the desired upload behaviour. These settings are found on the "Upload users preview" page.

'''Warning''': errors updating existing accounts can affect your users badly. '''''Be careful''''' when using the options to update.

====Upload type====
The Upload type specifies how to handle existing accounts.

;Add new only, skip existing users : is the default Moodle upload type. It creates a new user account for each new record in the uploaded file. If an existing username is found in the uploaded file matches an existing username, that record is '''skipped'''. By skipping the existing user account, the data in the existing record is not touched (in contrast to the "Add new and update existing users" option) and a second new user account is '''not''' created (in contrast to the "Add all, append number to usernames if needed" option).

;Add all, append number to usernames if needed : creates a new user account for each record in the uploaded file. If an existing user account is found, a new account will be created with a number appended to the username. For example, if a user account for username 'jsmith' already exists and a new record in the uploaded file contains a record forusername 'jsmith' an additional user account is created with a 1 '''appended''' to the username to produce user 'jsmith1'.

;Add new and update existing users : creates a new user account for each new user in the upload file. If an existing user account with the same username is found, the account information is '''updated''' by the data in the uploaded file.

;Update existing users only : ignores any new users found in the upload file and updates the user account if a matching username record is found in the uploaded file.

====New user password====
When creating a new user account Moodle can create a new password (if one is not provided) or require a password in the uploaded file.

;Create password if needed and send via email: creates a random default password for each new user account if one is not provided in the uploaded file, and emails the user their user information and new password.

;Field required in file : requires that a password be provided in the uploaded file in order. If a password is not provided, an error is generated and the user account is not created. No notification of this user information or password is sent to the user.

====Existing user details====
The Existing user details options are only available when the Upload type allows existing user accounts to be updated. It specifies how Moodle should process user detail information for existing users.

;No changes : ignores user detail data in the uploaded and leaves the existing user account data unchanged.
;Override with file : overwrites data in the existing user account with the data provided in the uploaded file.
;Override with file and defaults : overwrites data in the existing user account with data provided in the uploaded file and fills in the default values for existing user details when no data is provided in the uploaded file.
;Fill in missing from file and defaults : adds data in the existing user account with data provided in the uploaded file if the field is empty (does not already contain data) and fills in the default values for existing user details when no data is provided in the uploaded file.

====Existing user password====
The Existing user password option appears when you you have set the "Existing user details" setting to "Overwrite with file". It specifies how to handle password data for existing user accounts, to change them or leave them as it. This is a bit of insurance to make sure that you really want to mass change user passwords.

;No changes : ignores password field in the uploaded user file and leaves the existing user account password untouched
;Update : overwrites the existing user account password with the password provided in the uploaded file

====Force password change====
The Force password change option specifies when to tag a user account so that the next login attempt will require the user to change the user's password.

;Users having a weak password : If the user account has a weak password as defined by the site's [[Password_policy#Password_policy|Password policy]] then the user will be forced to change the password during the next login attempt. This option is not shown if there the site does not have a [[Password_policy#Password_policy|Password policy]].
;None : None of the users in the uploaded file will be forced to change the password during the user's next login attempt.
;All : All of the users in the uploaded file will be forced to change the password during the user's next login attempt.

====Allow renames====
If the uploaded file contains the special '''oldusername''' field, it is possible to rename a user from the '''oldusername''' to a new '''username'''. The default setting is to '''not''' allow renames. Keep in mind that renaming a user will require the user to use the new username when logging in.
;No : ignores the '''oldusername''' field and leaves the existing user account's username field unchanged.
;Yes : allows the existing user account's username to be changed by the data provided in the uploaded file's username field. The '''oldusername''' will be searched for and then updated with the data provided in the username column.

====Allow deletes====
If the uploaded file contains the '''deleted''' special field, it is possible to use the upload file to delete existing user accounts. The default setting is to '''not''' allow deletes. Keep in mind that deleting a user account will prevent that user from logging in. As a protection, site administrator user accounts cannot be deleted with this method.
;No : ignores the '''deleted''' special field in the uploaded file and leaves the existing user account unchanged
;Yes : allows the existing user account to be deleted when the value of the of the '''deleted''' field is 1.

====Allow suspending and activating of accounts====
If the uploaded file contains the '''suspended''' special field, it is possible to use the upload file to either suspend or make active (unsuspend) existing user accounts. The default setting is to allow suspending/activating of existing user accounts. Keep in mind that suspending an existing user account will prevent that user from logging in.
;Yes : allows the existing user account to be suspended when the value of the of the '''suspended''' field is 1.
;No : ignores the '''suspended''' special field in the uploaded file and leaves the existing user account status unchanged.

====Prevent email address duplicates====
It is possible, but '''not''' recommended to upload users with duplicate email addresses. By default, uploading users with duplicate email addresses is prevented. To allow duplicate email addresses, go to Site administration ► Plugins ► Authentication ► Manage authentication. You can tick "Allow accounts with same email". Then on the upload users screen you will be allowed to change the "Prevent email address duplicates" setting.

However, doing this is not recommended for file uploads. Test thoroughly any user uploads before implementing.

For more info, see the [[Managing_authentication#Allow_accounts_with_same_email|Managing authentication]] docs page
;Yes : prevents user accounts from being created from the uploaded if an existing user account already has the same email address as found in the uploaded file's '''email''' column.
;No : allows user accounts to be created if an existing user account already has the same email address found in the uploaded file's '''email''' column.

====Standardise usernames====
Standardise usernames is used by default to convert the username to all lower case and to strip out illegal characters. It is possible to not standardise the usernames; however, doing so is '''not''' recommended.
;Yes : standardises usernames found in the uploaded file before updating existing or creating new user accounts so that the username contains only lowercase letters and numbers.
;No : skips standardising usernames found in the uploaded file so that the newly created or updated usernames will be exactly as they are in the uploaded file ('''not recommended''').

For those seeking a more technical explanation, the process for standardising the usernames consists of ensuring the characters are all UTF-8 (fix_utf8) encoded, converting the username to lower case, and then stripping out non-letters/non-number characters (unless ''Site administration > Security > Site policies > Allow extended characters in usernames'' is set on) with something similar to:

<code>$username = preg_replace('/[^-\.@_a-z0-9]/', '', $username);</code>

====Select for bulk user actions====
After the uploaded file has finished being processed (all new accounts have been created and existing accounts updated as specified by the previous settings), there is an option to select some of those user accounts to perform additional [[admin/user/user_bulk|bulk user actions]] such as
*Confirm user accounts created through Email-based self-registration which are not yet confirmed by the user
*Send a message (requires Messaging to be enabled)
*Delete user accounts
*Display a list of users on a page
*Download user data in text, ODS or Excel file format
*Force users to change their passwords
*Add users to a cohort

By default, no users are selected for [[admin/user/user_bulk|bulk user actions]].

;No : No users are selected for [[admin/user/user_bulk|bulk user actions]]
;New users : Only newly created users are selected for [[admin/user/user_bulk|bulk user actions]]
;Updated users : Only updated user accounts are selected for [[admin/user/user_bulk|bulk user actions]]
;All users : All users found (existing updated users and newly created user accounts) in the uploaded file are selected for [[admin/user/user_bulk|bulk user actions]]

===Default values===

You can provide default user values for some fields not included in the uploaded file. Some fields include:

*Email display
*Forum auto-subscribe
*City/town
*ID number
*Institution
*Department

By clicking the '''Show more....''' link, other default user profile fields will show up. You can set 17 different fields here, including the Authentication method, Country. Language, Timezone, as well as most other standard User profile fields.

'''Other fields'''

If you have created any custom profile fields for your users, they will show up here.

==Upload user results ==
After accepting the preview settings by clicking on "Upload users", you should see the the Upload users results screen.
[[File:Upload users results 2.0.JPG|thumb|center|The results screen; everything went well!]]
This screen will show you any exceptions or changes that were made to each user in the upload process. For example if you were updating user information, the updated information will be shown. Or if a user was not added that record will be highlighted.

The screen will summarize how many users were uploaded or updated, indicate the number of weak passwords and the number of errors.

==Advanced potentials of Upload user==
===Templates===

''Note: This section needs checking and updating if necessary for Moodle 2.0. Please do so and remove this note when finished.''

The default values are processed as templates in which the following codes are allowed:

* %l - will be replaced by the lastname
* %f - will be replaced by the firstname
* %u - will be replaced by the username
* %% - will be replaced by the %

Between the percent sign (%) and any code letter (l, f or u) the following modifiers are allowed:

* (-) minus sign - the information specified by the code letter will be converted to lowercase
* (+) plus sign - the information specified by the code letter will be converted to UPPERCASE
* (~) tilde sign - the information specified by the code letter will be converted to Title Case
* a decimal number - the information specified by the code letter will be truncated to that many characters

For example, if the firstname is John and the lastname is Doe, the following values will be obtained with the specified templates:

* %l%f = DoeJohn
* %l%1f = DoeJ
* %-l%+f = doeJOHN
* %-f_%-l = john_doe
*<nowiki> http://www.example.com/~%u/</nowiki> results in <nowiki>http://www.example.com/~jdoe/</nowiki> (if the username is jdoe or %-1f%-l)

Template processing is done only on default values, and not on the values retrieved from the CSV file.

In order to create correct Moodle usernames, the username is always converted to lowercase. Moreover, if the "Allow extended characters in usernames" option in the Site policies page is off, characters different to letters, digits, dash (-) and dot (.) are removed. For example if the firstname is John Jr. and the lastname is Doe, the username %-f_%-l will produce john jr._doe when Allow extended characters in usernames is on, and johnjr.doe when off.

When the "New username duplicate handling" setting is set to Append counter, an auto-increment counter will be append to duplicate usernames produced by the template. For example, if the CSV file contains the users named John Doe, Jane Doe and Jenny Doe without explicit usernames, the default username is %-1f%-l and New username duplicate handling is set to Append counter, then the usernames produced will be jdoe, jdoe2 and jdoe3.

===Deleting accounts===

If the '''deleted''' field is present, users with value 1 for it will be deleted. In this case, all the fields may be omitted, except for '''username'''. After uploading the file, be sure to change the "Upload type" to "Update existing users only" and the "Allow deletes" option to "Yes".

''Tip:'' A similar field is available for '''suspended'''. This enables a user account to be temporarily disabled rather than completely removed.

Deleting and uploading accounts could be done with a single CSV file. For example, the following file will add the user Tom Jones and delete the user reznort:

username,firstname,lastname,deleted
jonest,Tom,Jones,0
reznort,,,1

==Encoding file format==
On the initial Upload user screen, you may select the file encoding format from a pull down list. These include UTF-8 (the default), ASCII, ISO-8859-1 to ISO-8859-11 or any one of over 36 formats.

==Hints==

===Spreadsheet===

If you use a spreadsheet program such as Excel to create your .csv file, check the resulting output in a text editor before you upload it. It is possible to get trailing commas on each line from an empty field if you have added and deleted columns of information prior to saving the final file. Also check the character encoding. A csv file is a simple text file (ASCII or Unicode) that can be used to upload user accounts.

Excel translates passwords that begin with - (minus) or + (plus) as zero. Even when saving as .csv and saying "Yes" to "Keep this format, and leave out any incompatible features." Check for this before uploading, as a zero halts the upload process.

If you use a formula in Excel to create fields (for example, the concatenate function to create a user name), then remember to copy the cells with the formula and use special paste with values checked to make them into an acceptable data for a csv file.

The upload will also fail if you have trailing spaces at the end of your data fields. Often, this can not be removed with a simple Find " " and Replace with "". If information has been copied from web sources than it is possible to include non-breaking spaces which will prevent your upload from being completed correctly. To find these invisible spaces, use the Find and Replace function in Excel. In the find field, hold alt and type 0160. Leave the replace field blank.

===Field size limits===
Some fields have maximum character lengths, as defined in the database fields. Typically the file will import to the preview list screen but not finish the process. Turn on debug to see the fields that are too long. The error will be "User not added - error".

The sizes of some common fields, in number of characters, are currently (3.2):

*username - 100
*password - 255
*idnumber - 255
*firstname - 100
*lastname - 100
*lastnamephonetic - 255
*firstnamephonetic - 255
*middlename - 255
*alternatename - 255
*institution - 255
*department - 255
*address - 255
*city - 120
*icq -15
*skype - 50
*yahoo - 50
*aim - 50
*msn - 50
*phone1 - 20
*phone2 - 20

===All user fields listed here===
:All the user fields that are valid in an upload file are listed below, except for any custom fields you may have created (for which see below.)

<pre>firstname,lastname,username,email,password,auth,idnumber,institution,department,city,country,timezone,lang,mailformat,maildisplay,maildigest,htmleditor,autosubscribe,skype,msn,aim,yahoo,icq,phone1,phone2,address,url,description,descriptionformat,interests,oldusername,deleted,suspended,alternatename,lastnamephonetic,firstnamephonetic,middlename</pre>

The enrolments into courses information are <pre>course1,type1,role1,group1,enrolperiod1,enrolstatus1</pre>
where each enrolment is grouped by number.

===Capabilities===

You may wish to create a limited role to allow some users access to this function. Create a role at the system/site level with the following capabilities allowed:
* moodle/site:uploadusers
* moodle/role:assign

And
* In 'Allow role assignments' tab of this new role, permit it to assign the required roles that it may be uploading, especially Student, but also Teacher, Non-editing Teacher, and any other custom roles you may have created, which will be used in the uploads to assign users to.

In particular, don't forget the moodle/role:assign capability (even if these users have it in the courses they will be enrolling users in - it won't work).

== See also ==
* [[Flat file]] enrolment
* [[User profile fields]] for details of how to include data about custom user profile fields in the upload users file
* [[Upload courses]]

Forum discussions:
*[http://moodle.org/mod/forum/discuss.php?d=97903 Uploading users to custom roles]
*[http://moodle.org/mod/forum/discuss.php?d=144569 Matriculacion con flat file csv] - discussion in Spanish

[[fr:Importer des utilisateurs]]
[[ja:ユーザのアップロード]]
[[de:Nutzerliste hochladen]]
[[es:Subir usuarios]]

Moodle app

2020-02-12T08:09:55Z

Krause:

{{Main page}}{{Mobile}}

__NOTOC__
==On the move with Moodle==
[[File:Mobile orientation.png|thumb|Access your Moodle course on your mobile]]

With the official mobile app for Moodle, you can

* Browse the content of your courses, even when offline
* Receive instant notifications of messages and other events
* Quickly find and contact other people in your courses
* Upload images, audio, videos and other files from your mobile device
* Track your progress, mark tasks as complete and browse your learning plans
* Attempt quizzes, post in forums and edit wiki pages
* View your course grades

... and lots more - see the full list of [[Moodle app features]].

==Using the app==

Note: The Moodle app will ONLY work with Moodle sites that have been set up to allow it. Site admins, please see the [[Moodle app guide for admins]].

Links to download the app are available in the footer and user profile pages when mobile access is enabled:

{{MediaPlayer | url = https://www.youtube.com/watch?v=wURqxr4eKs0 | desc = Video description}}

Teachers, for info on improving your courses for access via the app, please see [[Creating Moodle-app-friendly courses]].

==Staying up to date with new features and improvements==

Follow [https://twitter.com/moodleapps @moodleapps on Twitter] for news, updates and release announcements and join the discussions in the [https://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum] on moodle.org.

See [[New for mobile]] and the [[:dev:Moodle Mobile release notes|Moodle app release notes]] for details of new features recently added.

==See also==
* [[Moodle app FAQ]]
* [[Moodle Desktop]]

[[Category:Mobile]]

[[ca:Moodle Mobile]]
[[de:Mobiles Moodle]]
[[es:Moodle Mobile]]
[[fr:App Moodle]]
[[it:App Moodle]]
[[ja:モバイルアプリ]]

Moodle App Block support

2020-02-12T08:09:19Z

Krause:

{{Mobile}}
Blocks are supported on the App from 3.8 onwards.
This is the list of blocks supported on the app.

== Only title blocks ==
Some blocks have a match with the app features. It will only display the title and they will link the app feature directly when clicked:

* Calendar month
* Calendar upcoming
* Comments
* Completion status
* Learning plans
* Private files
* Self completion

== Pre-rendered blocks ==
Some blocks displays likely the same content as in the website:

* Badges
* Blog menu
* Blog recent
* Blog tags
* Glossary random
* HTML block
* News items
* Online Users
* Recent Activity
* RSS Client
* Tags

== Full supported blocks ==
Some blocks have an specific treatment on the app, they've been natively adapted:

* Activity modules
* Site Main menu (Site home)
* Course overview (Dashboard)
* Timeline (Dashboard)
* Starred Courses (Dashboard)
* Recent accessed items (Dashboard)
* Recent Courses (Dashboard)

[[es:Soporte para Bloque en Moodle App]]

Template:Mobile

2020-02-12T08:08:50Z

Krause: /* Template:Mobile */

<div class="navtrail">[[Main page]] ► [[Managing a Moodle site]] ► [[Moodle app]] ► [[{{PAGENAME}}]]</div>
<div class="sideblock right" style="width: 14em;">
<div class="header">[[Moodle app]]</div>
<div class="content">
* [[Moodle app features]]
* [[New for mobile]]
* [[Moodle app guide for admins]]
* [[Moodle app notifications]]
* [[Creating mobile-friendly courses]]
* [[Moodle App Block support]]
* [[Moodle Desktop]]
* [[Moodle app FAQ]]
</div>
</div>

<includeonly>[[Category:Mobile]]</includeonly>
<noinclude>This template will categorize articles that include it into [[:Category:Mobile]].</noinclude>

Talk:Moodle app features

2018-12-13T09:06:00Z

Krause: Created page with "Hi Juan, do we need the "Comparison of features in different versions" at the bottom of this page? I think, that nobody will still be using an older app. Ralf"

Hi Juan,
do we need the "Comparison of features in different versions" at the bottom of this page? I think, that nobody will still be using an older app.
Ralf

Creating mobile-friendly courses

2018-06-02T17:47:44Z

Krause: /* Learn more */

{{Mobile}}
As more and more students access courses from their smartphones, tablets or other mobile devices, it is increasingly important to ensure your courses are mobile-friendly.

Encouraging students to install the [https://download.moodle.org/mobile/ official Moodle mobile app] is one way to improve their learning experience. Below are some suggestions for optimising your course materials for students both using the app and accessing Moodle from mobile devices.

==Use a mobile-friendly theme==

Recent versions of Moodle allow for responsive themes, which adapt to the browser screen size. Make sure your course uses such a theme and check its contents yourself before your students start the course.

Please, notice that a responsive theme does not have any visual impact in the Mobile app.

==Use the latest Moodle version available or the Moodle Mobile additional features plugin==

As indicated in [[Moodle Mobile features]] some features are only available in recent Moodle versions.

It is recommended to use the latest Moodle version or, if is not possible to upgrade your site, install the [[Moodle Mobile additional features]] plugin.

==Notifications and messages==

Encourage your students to enable mobile notifications so they are alerted about calendar events, forum posts, messages, assignment submissions and so on. Find out more in [[Mobile app notifications]].

You can also enable mobile notifications for all the users by default via the [[Messaging settings]] default message outputs. Students can disable Mobile notifications within the app.

==Provide a 'how to' guide to Moodle on the mobile==

Consider offering your students a guide (as a PDF or a page resource) on how to access your course on the app, what they can do and not (yet) do from the app. Read up on the [[Moodle Mobile features]] and what's [[New for mobile]].

==Setting up your course==

*Topics or weekly course format is best suited to mobile devices.
*Don't use orphaned activities or direct links to activities (the links will work but is not the best experience for mobile).
*If you have a mix of students accessing the course on mobile and desktop, consider asking your admin to install the [[Moodle Mobile availability plugin]] which restricts items to desktop or mobile users.
*Site or course blocks are not displayed in the Mobile app, avoid putting important information in blocks.

==Course content==

*Use responsive HTML in pages or mini-sites.
*Try to use a [[Page resource|page resource]] instead of downloadable documents where possible.
*Avoid uploading many documents or having numerous, text heavy pages. Think more in terms of short "information-bytes".
*If you include YouTube videos, provide them also for download and offline viewing in a [[Folder resource|folder]]. Not all video formats are supported so add them in different formats. (MP4 is probably the most widely accepted format.)
*Drag and drop questions behave differently in the app. You can't drag images, you need to tap to select and tap to drop.
*Note that if you add YouTube video links or map links as URL resources, they will open automatically in the app.
{|
| [[File:moodlemobile_short_text_intro.png|thumb|Short text for label]]
| [[File:moodlemobile_responsive_html.png|thumb|Responsive HTML]]
| [[File:moodlemobile_youtube_maps_links.png|thumb|Map link]]
|}
* Use only plugins which provide support so they can be accessed via the mobile app - see [https://moodle.org/plugins/browse.php?list=award&id=6 Moodle plugins directory: Award: mobile app support].
* If you want to include large audio files in your course, please consider to included them embedded in a label or HTML page content instead as a file. The reason is that embedded files will play even if the screen is locked but files won't play with the screen locked.

===Media download for offline usage===

To enable media files, such as video, to be downloaded

* The file must be uploaded to the course, rather than being linked to (from YouTube, Vimeo etc)
* The file must be small - less than 2MB for 3G users or less than 20MB for WiFi users

When a page containing the video is viewed (without playing the video), the file will then be downloaded.

When using Moodle Mobile 3.1 with a WiFi connection, when the video is played, the file will be downloaded in the background. The next time the video is played, the downloaded file will be used.

===Offline activities===

All the supported activities work offline, although some require specific settings like the quiz module, see [[Moodle Mobile quiz offline attempts]] for more information.

=== Things to avoid===

Some activities are not yet fully supported by the mobile app, so find alternatives. See [[Moodle Mobile SCORM player]] for things to avoid in SCORM packages.

You can find the list of activities supported by the app in the [[Moodle Mobile features]] page.

==Mobile device considerations==

The app works better on devices running
* Android 4.4 onwards
* iOs 6 onwards

In old devices you may find problems related to:
* User interface
* Connection problems (specifically when connecting to sites using https certificates)
* Slowness

The first version of the app was supported in Windows Phone and Windows 7. This version is not supported anymore and it was withdrawn from the Windows Store. Its usage is not advised.

==Links to open the Moodle Mobile app==

If required, links which open the Moodle Mobile app may be provided in the course (for users browsing the site using a mobile device with the app installed).

Links are of the form <code>moodlemobile://link=https://yourmoodlesite.org/mod/...</code>

For example, the link <code>moodlemobile://link=https://mysite.es/mod/choice/view.php?id=8</code> will open the mobile app and display a choice activity.

==Learn more==

* A "[http://mobile.moodlebites.com free Moodle Mobile MOOC]" run by [http://www.hrdnz.com HRDNZ] (Moodle Partner) twice a year, specifically focussing on the use of Moodle with mobile devices, and how to best design courses for these environments - including the Moodle Mobile App.
* [http://es.slideshare.net/juanleyva/tips-for-creating-moodle-mobile-friendly-courses-sites-moodlemoot-spain-2014 Tips for creating Moodle Mobile friendly courses and sites - MoodleMoot Spain 2014] - Juan Leyva, Mobile app developer, presented this in 2014. While some features have now been updated, the general principles are still useful.
* An open course, about "[http://tempus-efa.proj.ac.il/moodle/course/view.php?id=102 Teaching using Mobile - Best practices]"
*Forum post: [https://moodle.org/mod/forum/discuss.php?d=349160 Try the Moodle Mobile app with a mobile-friendly course].

[[de:Moodle Mobile - Websites optimieren]]
[[es:Crear sitios amistosos para Moodle Mobile]]
[[fr:Créer des cours pour appareils mobiles]]

Installation Package for OS X

2016-09-19T14:08:15Z

Krause: /* System requirements */

{{Installing Moodle}}
==Summary==
The complete install packages for Mac OS X are named Moodle4Mac and allow a very easy way to install Moodle on your Mac computer (laptop, desktop or test server). Moodle4Mac is available from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X].

Moodle4Mac is based on the software MAMP. MAMP contains everything that is necessary for the operation of Moodle - the Apache web server, MySQL database and PHP scripting language. Packages are available for different Moodle versions. Please check which Moodle your institution (school, college, university, company) uses on its server so that you can swap your materials between the two platforms easily.

You can also install the latest Moodle development version to find everything about upcoming opportunities and changes. However, please remember that a developer version is not yet a finished product, and thus may contain errors.

Moodle4Mac packages also include a special Git update script, enabling you to easily update your Moodle site without needing to download the whole package again and without reinstalling all your courses.

Note: Moodle4Mac is NOT intended to be used for a production server on the Internet. It is only intended for installation on a local computer to test and develop, as it is not optimized for security.

==System requirements==
+ Apple OS X Computer
+ iMac, Mac mini, MacBook, MacBook Air, Mac Pro
+ Processor: Intel x86_64 (i5, i7, Xeon, Core 2 Duo)
+ RAM: 4 GB or better
+ Hard Disk: 4 GB free
+ System Software: OS X 10.6.8, 10.7, 10.8, 10.9, 10.10, 10.11

==Download and install ==
'''Step 1:''' Download the disk image '''Moodle4Mac.dmg''' from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X] . You will find various image files for the different Moodle versions.

'''Step 2:''' Double click the disk image '''Moodle4Mac.dmg''' to mount the installation disk.

[[Image:Moodle4Mac_1.png|500px]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac OS X, Apache, MySQL, PHP). MAMP does not save parameters in a registry or in system variables. If you want to delete Moodle4Mac you only need to move the MAMP folder into the Trash. For more information about MAMP please look at the [http://mamp.info/ MAMP project page].

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

[[Image:Moodle4Mac_2.png|500px]]

'''Step 5:''' Double click the MAMP icon to start the server.

[[Image:Moodle4Mac_3.png|500px]]

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

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

[[Image:Moodle4Mac_4.png|900px]]

==Language packages==

By default Moodle4Mac is in English only; other languages must be installed. For example, you may want to switch your site to German. The German standard package ''de'' translates all text strings to German, the additional package ''de_du'' adds the informal conversation ''du'', the additional package ''de_kids'' provides scholastic simplifications.

Additional [[Language packs|language packs]] may be imported via ''Administration > Site administration > Language > Language packs''.

[[Image:Moodle4Mac_5.png|900px]]

After importing the additional language pack, the settings for the default language for the user account '''admin''' can be switched to German.

==Completely backup your server==
Just as you installed Moodle4Mac the first time on your computer, you can backup a customised system completely. Because all files and configurations are stored within the directory MAMP, you can easily backup your MAMP directory to an external disk. A snapshot of our Moodle site will be saved together with all settings and all the courses, and it can be recovered at any time in the same form.

First stop all server processes like httpd and mysqld, then exit the MAMP program. After everything has stopped you can copy or move the MAMP directory. If you want to transfer MAMP to one or more other computers, you need to create a ZIP archive containing the MAMP directory. This ZIP archive can be copied anywhere ... to an USB memory stick, to a web server, on a burned CD ...

The target computer must be a Mac. On this Mac, unpack the ZIP archive and move the MAMP folder to the Application folder ... done! Everything is going exactly as in the section download and installation. In this way you can prepare your Moodle for a presentation or a training lab, and then distribute it.

[[Image:Moodle4Mac_ZIP.png|500px]]

==Server in your local network==

In various workshops we used Moodle4Mac as a quick server installation for our local network. Make sure that you change the passwords for Moodle and MySQL before you allow access to this server ... otherwise, you'll be amazed how creative your user group can be. Please read the safety instructions of Moodle4Mac.

In this section you will see all required settings to use the server in the local network. Only three steps are required. The first step is to change one line in the config.php for Moodle. In the second step you need to adjust the base address in Moodle. And in your third step you open the firewall for ''httpd''.

To get your Moodle to another computer in your local network your Mac must be clearly addressable. You may use a fixed IP address or a DNS name. In local networks usually ip addresses of the private sections 10.xxx , 172.xxx , or 192.168.xx are assigned. If your Moodle4Mac gets an ip address this address must never change. Please do not use any static ip address if you do not know exactly what you do ... in case of doubt ask the administrator of the local network.

You can't use Moodle4Mac as a local server which is intended to work on different networks.

====Edit config.php====
For the following your computer should be a Mac in a computer lab. For this example it has the the fixed ip address 192.168.0.200. You must edit now the configuration ''/Applications/MAMP/htdocs/moodle24/config.php'' and change the wwwroot from ''localhost'' to ''192.168.0.200''. You must use your own address for your own network!!

After your changes you should get your Moodle with the address http://192.168.0.200/moodle24/

<pre><?php /// Moodle configuration file

unset($CFG);
global $CFG;
$CFG = new stdClass();

$CFG->dbtype = 'mysqli';
$CFG->dblibrary = 'native';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle28';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->prefix = 'mdl_';
$CFG->dboptions = array (
'dbpersit' => 0,
'dbport' => '',
'dbsocket' => 1,
);

// localhost wird auf 192.168.0.200 geändert
// $CFG->wwwroot = 'http://localhost:8888/moodle28';
$CFG->wwwroot = 'http://192.168.0.200:8888/moodle28';
$CFG->dataroot = '/Applications/MAMP/data/moodle28';
$CFG->admin = 'admin';

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

require_once(dirname(__FILE__) . '/lib/setup.php');

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

====Replace internal links in Moodle====
The original base address ''localhost'' is stored in many places within the database, your Moodle will not work properly with the modified base address. But images can not be displayed because they are accessible only from their correct address. From your local computer you might not see the problems but if you are outside on a computer getting access to the site.

Moodle has a tool that allows you to replace the database entries from http://localhost:8888/moodle24/ to http://192.168.0.200:8888/moodle28/ .

[[Image:Moodle4Mac_6.png|900px]]

You call this tool via the address http://192.168.0.200:8888/moodle28/admin/tool/replace/

No ... there is no menu option for it, probably because at thoughtless action with this tool also can shred the database ... in the first field enter http://localhost:8888/moodle28/, in the second field http://192.168.0.200:8888/moodle28/ (or the ip address that you have assigned in your installation). Use the correct spelling in both fields! With the hook you acknowledge that you know about the risk ...

====Open the firewall====
The firewall in OS X 10.6, 10.7, 10.8, and 10.9 can be enabled and disabled the ''System Preferences > Security > Firewall''. If the firewall is disabled, although Moodle4Mac works without further settings in the network, but your computer is vulnerable to all requests from the outside ... the latter you should not do!

[[Image:Moodle4Mac_Firewall1.png|520px]]

The the system firewall of OS X is a packet filter that determines for each program if a data packet should be passed or blocked. If the firewall is enabled every program must be entered on a list to respond to requests from outside. Moodle4Mac (or MAMP) uses the httpd program to deliver the sites. You will find httpd in the MAMP folder ... the path is ''/Application/MAMP/Library/bin/httpd''. To enter httpd into the whitelist of the firewall you must click forward on this path ... no idea if there would be a configuration file which you can edit.

You need to get this setting for the firewall only once. If httpd is approved then all computers in your local network can access to Moodle ... by the way it is not important which is used by httpd ... port 8888 or port 80.

Do not open the firewall for mysqld because Moodle itself gets a connection to mysql on the server but no user should communicate with mysql directly from the client.

[[Image:Moodle4Mac_Firewall2.png|520px]]

====Connect Moodle from your local network====
Your web server can be connected with the url http://192.168.0.200:8888/moodle28/ in your local network, where 192.168.0.200 is an example address which your Mac got from the local router. Usually such local numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x and you will be able to do your settings even if they differ from this description.

When you got all settings right then all users from any computer in your network will see your Moodle via http://192.168.0.200:8888/moodle28/. And there will be no problem with any operating system.

[[Image:Moodle4Mac_7.png|900px]]

====Connect Moodle from your local network with mobile devices====
The following images show the locale Moodle site with an iPad and an iPhone.

[[image:Moodle4Mac_8.png|890px]]

[[image:Moodle4Mac_9.png|490px]]

==Some words about the security ...==

====MAMP is not secure!====
MAMP can be used for testing and developing web sites locally on a Mac computer. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. MAMP is prepared for an easy start and not for a public web server!! But with some careful modifications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments. Be careful!

====How to secure MAMP?====
Moodle4Mac is a preconfigured package where all the default settings are accessible. The password for the Moodle admin user is known and must necessarily be changed.

But please do not think that this should be enough! Your Moodle could also be attacked through the back door via the database. You definitely need to change the passwords of the database users root and moodle, because these passwords are known. Otherwise any hacker could change the password of the user account admin to get full access to all the information in Moodle. Alternatively, the hacker could also assign another user account to full admin access and he would be able to read all informations ... the main admin would probably not notice of such a change. It is also possible to delete the database completely if you know the root access to the database so that all information could be lost in this case.

====Secure connections with HTTPS====
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (except for the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==
It is very simple to update your locally installed Moodle. You start the update with a double click and everything happens automatically. All courses rest in Moodle. You do not need to renew your local Moodle completely ... you only get the new Moodle files.

====Update the local Moodle via Git====
Make sure that the Git program is installed on your Mac (see instructions below). You also need an Internet connection because the files are downloaded from the Moodle update server. A double click on the icon UpdateMoodle.sh starts the script and updating occurs automatically. That's really all ... could it be easier?

[[Image:Moodle4Mac_Update1.png]]

The Git program connects to the Moodle server and controls which files are new, which have changed and which have been deleted. The transmission time depends on the internet connection. With Git only really necessary files will be transmitted. If the transfer takes too long, you can abort the process with <ctrl>-c. You can easily start the update again later.

[[Image:Moodle4Mac_Update2.png|550px]]

  

====Script control ... looking inside ... ====

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor, e.g. TextWrangler.

It is only a text file but it uses a OS X feature to open and execute the script with the Terminal program. You don't need to learn anything ... doubleclick to update everything.

<pre>
#! /bin/sh
#
# This GIT installer for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20150511 - Ralf Krause
#

echo
echo "+--------------------------------------------+"
echo "| GIT updater for your local Moodle server"
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs

if ! test -e moodle28/.git ; then
## the first git update must get everything including .git
git clone --depth 1 -b MOODLE_28_STABLE git://github.com/moodle/moodle.git moodle28-git
if test -e moodle28-git ; then
if test -e moodle28 ; then
if test -e moodle28/config.php ; then
cp moodle28/config.php moodle28-git/.
fi
DATE=`date +%Y%m%d-%H%M`
mv moodle28 moodle28-$DATE
fi
mv moodle28-git moodle28
fi
## the old folder can be deleted now
## if you want to do this please remove '##' from the following line
## sudo rm -R moodle28-*
else
## the next git update only gets the new files
cd moodle28
git pull
cd ..
fi
</pre>

The different versions of the script UpdateMoodle.sh only differ in two parameters ... first we need to know the right folder for Moodle and second we must use the correct git tag for the Moodle version. The shown script upgrades Moodle 2.8.
* Moodle 2.7 uses MOODLE_27_STABLE
* Moodle 2.8 uses MOODLE_28_STABLE
* Moodle 2.9 uses MOODLE_29_STABLE
* Moodle 3.0 uses MOODLE_30_STABLE
* Moodle 3.1 uses MOODLE_31_STABLE
* Moodle 3.2dev uses master

====Install Git====

Download the Git program from http://git-scm.com/download/ ... it's free and open source.

[[Image:Moodle4Mac_Git1.png]]
  

Open the disk image and doubleclick the installer git-xxx-osx.pkg. If you want to know more about Git then read the Git documentation on their web site ... but if you only want to update Moodle the script '''UpdateMoodle.sh''' should also work without reading

[[Image:Moodle4Mac_Git2.png|500px]]
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [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]

[[Category:Mac OS X]]

[[de:Installationspaket für OS X]]
[[es:Paquetes de Instalación Completos para Mac OS X]]

Moodle app notifications

2016-08-02T11:53:19Z

Krause:

{{Mobile}}

==For students and teachers==
[[File:12Notifications.png|thumb|Forum post notification]]
The Moodle mobile app lets you keep up to date with all that's happening in your courses and on the site. Every time you open the app, events are synchronised with the main website.

You will receive [[Calendar|Moodle calendar]] event notifications automatically. If you don't want to get them, you can turn them all off individually in the Calendar events options in the main menu.

You will also receive notifications of messages, forum posts, submitted assignments etc (known as 'push notifications') if your site administrator has enabled these. To receive these notifications you need to enable them for your mobile on the main site, from the user menu top right >''Preferences>Messaging.''

==For administrators==

Push notifications can be enabled by an administrator by connecting their Moodle site to a messaging server such https://messages.moodle.net (available for [[Site registration|registered Moodle sites]] only). An access key can be obtained via ''Administration > Site administration > Plugins > Message outputs > Mobile Notifications''. (If you have problems requesting the access key, please fill in the [http://goo.gl/forms/WLwkbe8b7c Airnotifier access key manual request form]. Your site registration will be checked and you will be sent an access key in a few days if everything is correct.)

Users then need to connect at least once with the latest version of the Moodle Mobile app in order to register their phones with the Moodle site.

=== Event Reminders plugin===

Push notifications can also include calendar event notifications, however this requires the [https://moodle.org/plugins/view/local_reminders Event Reminders plugin] to be installed on the Moodle site.

The Event Reminders plugin will automatically send reminders for Moodle calendar events in a timely manner via Moodle message interface. It also allows users to control how they receive messages for each type of event in the Moodle calendar.

=== Installing your own notifications infrastructure ===

If you have a customized version of the Moodle Mobile app, or you want to use your own notifications infrastructure, you will have to install a private [http://airnotifier.github.io AirNotifier] (backend server for notifications).

https://messages.moodle.net uses a slightly modified version of Airnotifier: https://github.com/moodlehq/airnotifier/tree/moodle2.

You will have to add your app certificates - see https://github.com/airnotifier/airnotifier/wiki/Installation for further information.

The Airnotifier message plugin allows you to point to your custom Airnotifier instance using your own access keys.

Remember to install using GIT (repository https://github.com/moodlehq/airnotifier.git branch ''moodle2'').

[[de:Moodle Mobile - Benachrichtigungen]]
[[ca:Notificacions_de_la_app_Mobile]]
[[es:Mobile app Notificaciones Push]]
[[fr:Notifications de l'app mobile]]

Installation Package for OS X

2016-05-24T08:03:35Z

Krause: /* Download and install */

{{Installing Moodle}}
==Summary==
The complete install packages for Mac OS X are named Moodle4Mac and allow a very easy way to install Moodle on your Mac computer (laptop, desktop or test server). Moodle4Mac is available from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X].

Moodle4Mac is based on the software MAMP. MAMP contains everything that is necessary for the operation of Moodle - the Apache web server, MySQL database and PHP scripting language. Packages are available for different Moodle versions. Please check which Moodle your institution (school, college, university, company) uses on its server so that you can swap your materials between the two platforms easily.

You can also install the latest Moodle development version to find everything about upcoming opportunities and changes. However, please remember that a developer version is not yet a finished product, and thus may contain errors.

Moodle4Mac packages also include a special Git update script, enabling you to easily update your Moodle site without needing to download the whole package again and without reinstalling all your courses.

Note: Moodle4Mac is NOT intended to be used for a production server on the Internet. It is only intended for installation on a local computer to test and develop, as it is not optimized for security.

==System requirements==
+ Apple OS X Computer
+ iMac, Mac mini, MacBook, MacBook Air, Mac Pro
+ Processor: Intel x86_64 (i5, i7, Xeon, Core2Duo)
+ RAM: 4 GB or better
+ Hard Disk: 4 GB free
+ System Software: OS X 10.6.8, 10.7, 10.8, 10.9, 10.10, 10.11

==Download and install ==
'''Step 1:''' Download the disk image '''Moodle4Mac.dmg''' from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X] . You will find various image files for the different Moodle versions.

'''Step 2:''' Double click the disk image '''Moodle4Mac.dmg''' to mount the installation disk.

[[Image:Moodle4Mac_1.png|500px]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac OS X, Apache, MySQL, PHP). MAMP does not save parameters in a registry or in system variables. If you want to delete Moodle4Mac you only need to move the MAMP folder into the Trash. For more information about MAMP please look at the [http://mamp.info/ MAMP project page].

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

[[Image:Moodle4Mac_2.png|500px]]

'''Step 5:''' Double click the MAMP icon to start the server.

[[Image:Moodle4Mac_3.png|500px]]

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

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

[[Image:Moodle4Mac_4.png|900px]]

==Language packages==

By default Moodle4Mac is in English only; other languages must be installed. For example, you may want to switch your site to German. The German standard package ''de'' translates all text strings to German, the additional package ''de_du'' adds the informal conversation ''du'', the additional package ''de_kids'' provides scholastic simplifications.

Additional [[Language packs|language packs]] may be imported via ''Administration > Site administration > Language > Language packs''.

[[Image:Moodle4Mac_5.png|900px]]

After importing the additional language pack, the settings for the default language for the user account '''admin''' can be switched to German.

==Completely backup your server==
Just as you installed Moodle4Mac the first time on your computer, you can backup a customised system completely. Because all files and configurations are stored within the directory MAMP, you can easily backup your MAMP directory to an external disk. A snapshot of our Moodle site will be saved together with all settings and all the courses, and it can be recovered at any time in the same form.

First stop all server processes like httpd and mysqld, then exit the MAMP program. After everything has stopped you can copy or move the MAMP directory. If you want to transfer MAMP to one or more other computers, you need to create a ZIP archive containing the MAMP directory. This ZIP archive can be copied anywhere ... to an USB memory stick, to a web server, on a burned CD ...

The target computer must be a Mac. On this Mac, unpack the ZIP archive and move the MAMP folder to the Application folder ... done! Everything is going exactly as in the section download and installation. In this way you can prepare your Moodle for a presentation or a training lab, and then distribute it.

[[Image:Moodle4Mac_ZIP.png|500px]]

==Server in your local network==

In various workshops we used Moodle4Mac as a quick server installation for our local network. Make sure that you change the passwords for Moodle and MySQL before you allow access to this server ... otherwise, you'll be amazed how creative your user group can be. Please read the safety instructions of Moodle4Mac.

In this section you will see all required settings to use the server in the local network. Only three steps are required. The first step is to change one line in the config.php for Moodle. In the second step you need to adjust the base address in Moodle. And in your third step you open the firewall for ''httpd''.

To get your Moodle to another computer in your local network your Mac must be clearly addressable. You may use a fixed IP address or a DNS name. In local networks usually ip addresses of the private sections 10.xxx , 172.xxx , or 192.168.xx are assigned. If your Moodle4Mac gets an ip address this address must never change. Please do not use any static ip address if you do not know exactly what you do ... in case of doubt ask the administrator of the local network.

You can't use Moodle4Mac as a local server which is intended to work on different networks.

====Edit config.php====
For the following your computer should be a Mac in a computer lab. For this example it has the the fixed ip address 192.168.0.200. You must edit now the configuration ''/Applications/MAMP/htdocs/moodle24/config.php'' and change the wwwroot from ''localhost'' to ''192.168.0.200''. You must use your own address for your own network!!

After your changes you should get your Moodle with the address http://192.168.0.200/moodle24/

<pre><?php /// Moodle configuration file

unset($CFG);
global $CFG;
$CFG = new stdClass();

$CFG->dbtype = 'mysqli';
$CFG->dblibrary = 'native';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle28';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->prefix = 'mdl_';
$CFG->dboptions = array (
'dbpersit' => 0,
'dbport' => '',
'dbsocket' => 1,
);

// localhost wird auf 192.168.0.200 geändert
// $CFG->wwwroot = 'http://localhost:8888/moodle28';
$CFG->wwwroot = 'http://192.168.0.200:8888/moodle28';
$CFG->dataroot = '/Applications/MAMP/data/moodle28';
$CFG->admin = 'admin';

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

require_once(dirname(__FILE__) . '/lib/setup.php');

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

====Replace internal links in Moodle====
The original base address ''localhost'' is stored in many places within the database, your Moodle will not work properly with the modified base address. But images can not be displayed because they are accessible only from their correct address. From your local computer you might not see the problems but if you are outside on a computer getting access to the site.

Moodle has a tool that allows you to replace the database entries from http://localhost:8888/moodle24/ to http://192.168.0.200:8888/moodle28/ .

[[Image:Moodle4Mac_6.png|900px]]

You call this tool via the address http://192.168.0.200:8888/moodle28/admin/tool/replace/

No ... there is no menu option for it, probably because at thoughtless action with this tool also can shred the database ... in the first field enter http://localhost:8888/moodle28/, in the second field http://192.168.0.200:8888/moodle28/ (or the ip address that you have assigned in your installation). Use the correct spelling in both fields! With the hook you acknowledge that you know about the risk ...

====Open the firewall====
The firewall in OS X 10.6, 10.7, 10.8, and 10.9 can be enabled and disabled the ''System Preferences > Security > Firewall''. If the firewall is disabled, although Moodle4Mac works without further settings in the network, but your computer is vulnerable to all requests from the outside ... the latter you should not do!

[[Image:Moodle4Mac_Firewall1.png|520px]]

The the system firewall of OS X is a packet filter that determines for each program if a data packet should be passed or blocked. If the firewall is enabled every program must be entered on a list to respond to requests from outside. Moodle4Mac (or MAMP) uses the httpd program to deliver the sites. You will find httpd in the MAMP folder ... the path is ''/Application/MAMP/Library/bin/httpd''. To enter httpd into the whitelist of the firewall you must click forward on this path ... no idea if there would be a configuration file which you can edit.

You need to get this setting for the firewall only once. If httpd is approved then all computers in your local network can access to Moodle ... by the way it is not important which is used by httpd ... port 8888 or port 80.

Do not open the firewall for mysqld because Moodle itself gets a connection to mysql on the server but no user should communicate with mysql directly from the client.

[[Image:Moodle4Mac_Firewall2.png|520px]]

====Connect Moodle from your local network====
Your web server can be connected with the url http://192.168.0.200:8888/moodle28/ in your local network, where 192.168.0.200 is an example address which your Mac got from the local router. Usually such local numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x and you will be able to do your settings even if they differ from this description.

When you got all settings right then all users from any computer in your network will see your Moodle via http://192.168.0.200:8888/moodle28/. And there will be no problem with any operating system.

[[Image:Moodle4Mac_7.png|900px]]

====Connect Moodle from your local network with mobile devices====
The following images show the locale Moodle site with an iPad and an iPhone.

[[image:Moodle4Mac_8.png|890px]]

[[image:Moodle4Mac_9.png|490px]]

==Some words about the security ...==

====MAMP is not secure!====
MAMP can be used for testing and developing web sites locally on a Mac computer. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. MAMP is prepared for an easy start and not for a public web server!! But with some careful modifications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments. Be careful!

====How to secure MAMP?====
Moodle4Mac is a preconfigured package where all the default settings are accessible. The password for the Moodle admin user is known and must necessarily be changed.

But please do not think that this should be enough! Your Moodle could also be attacked through the back door via the database. You definitely need to change the passwords of the database users root and moodle, because these passwords are known. Otherwise any hacker could change the password of the user account admin to get full access to all the information in Moodle. Alternatively, the hacker could also assign another user account to full admin access and he would be able to read all informations ... the main admin would probably not notice of such a change. It is also possible to delete the database completely if you know the root access to the database so that all information could be lost in this case.

====Secure connections with HTTPS====
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (except for the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==
It is very simple to update your locally installed Moodle. You start the update with a double click and everything happens automatically. All courses rest in Moodle. You do not need to renew your local Moodle completely ... you only get the new Moodle files.

====Update the local Moodle via Git====
Make sure that the Git program is installed on your Mac (see instructions below). You also need an Internet connection because the files are downloaded from the Moodle update server. A double click on the icon UpdateMoodle.sh starts the script and updating occurs automatically. That's really all ... could it be easier?

[[Image:Moodle4Mac_Update1.png]]

The Git program connects to the Moodle server and controls which files are new, which have changed and which have been deleted. The transmission time depends on the internet connection. With Git only really necessary files will be transmitted. If the transfer takes too long, you can abort the process with <ctrl>-c. You can easily start the update again later.

[[Image:Moodle4Mac_Update2.png|550px]]

  

====Script control ... looking inside ... ====

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor, e.g. TextWrangler.

It is only a text file but it uses a OS X feature to open and execute the script with the Terminal program. You don't need to learn anything ... doubleclick to update everything.

<pre>
#! /bin/sh
#
# This GIT installer for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20150511 - Ralf Krause
#

echo
echo "+--------------------------------------------+"
echo "| GIT updater for your local Moodle server"
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs

if ! test -e moodle28/.git ; then
## the first git update must get everything including .git
git clone --depth 1 -b MOODLE_28_STABLE git://github.com/moodle/moodle.git moodle28-git
if test -e moodle28-git ; then
if test -e moodle28 ; then
if test -e moodle28/config.php ; then
cp moodle28/config.php moodle28-git/.
fi
DATE=`date +%Y%m%d-%H%M`
mv moodle28 moodle28-$DATE
fi
mv moodle28-git moodle28
fi
## the old folder can be deleted now
## if you want to do this please remove '##' from the following line
## sudo rm -R moodle28-*
else
## the next git update only gets the new files
cd moodle28
git pull
cd ..
fi
</pre>

The different versions of the script UpdateMoodle.sh only differ in two parameters ... first we need to know the right folder for Moodle and second we must use the correct git tag for the Moodle version. The shown script upgrades Moodle 2.8.
* Moodle 2.7 uses MOODLE_27_STABLE
* Moodle 2.8 uses MOODLE_28_STABLE
* Moodle 2.9 uses MOODLE_29_STABLE
* Moodle 3.0 uses MOODLE_30_STABLE
* Moodle 3.1 uses MOODLE_31_STABLE
* Moodle 3.2dev uses master

====Install Git====

Download the Git program from http://git-scm.com/download/ ... it's free and open source.

[[Image:Moodle4Mac_Git1.png]]
  

Open the disk image and doubleclick the installer git-xxx-osx.pkg. If you want to know more about Git then read the Git documentation on their web site ... but if you only want to update Moodle the script '''UpdateMoodle.sh''' should also work without reading

[[Image:Moodle4Mac_Git2.png|500px]]
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [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]

[[Category:Mac OS X]]

[[de:Installationspaket für OS X]]
[[es:Paquetes de Instalación Completos para Mac OS X]]

Installation Package for OS X

2016-05-24T08:02:41Z

Krause: /* System requirements */

{{Installing Moodle}}
==Summary==
The complete install packages for Mac OS X are named Moodle4Mac and allow a very easy way to install Moodle on your Mac computer (laptop, desktop or test server). Moodle4Mac is available from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X].

Moodle4Mac is based on the software MAMP. MAMP contains everything that is necessary for the operation of Moodle - the Apache web server, MySQL database and PHP scripting language. Packages are available for different Moodle versions. Please check which Moodle your institution (school, college, university, company) uses on its server so that you can swap your materials between the two platforms easily.

You can also install the latest Moodle development version to find everything about upcoming opportunities and changes. However, please remember that a developer version is not yet a finished product, and thus may contain errors.

Moodle4Mac packages also include a special Git update script, enabling you to easily update your Moodle site without needing to download the whole package again and without reinstalling all your courses.

Note: Moodle4Mac is NOT intended to be used for a production server on the Internet. It is only intended for installation on a local computer to test and develop, as it is not optimized for security.

==System requirements==
+ Apple OS X Computer
+ iMac, Mac mini, MacBook, MacBook Air, Mac Pro
+ Processor: Intel x86_64 (i5, i7, Xeon, Core2Duo)
+ RAM: 4 GB or better
+ Hard Disk: 4 GB free
+ System Software: OS X 10.6.8, 10.7, 10.8, 10.9, 10.10, 10.11

==Download and install ==
'''Step 1:''' Download the disk image '''Moodle4Mac-MAMP.dmg''' from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X] . You will find various image files for the different Moodle versions.

'''Step 2:''' Double click the disk image '''Moodle4Mac-MAMP.dmg''' to mount the installation disk.

[[Image:Moodle4Mac_1.png|500px]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac OS X, Apache, MySQL, PHP). MAMP does not save parameters in a registry or in system variables. If you want to delete Moodle4Mac you only need to move the MAMP folder into the Trash. For more information about MAMP please look at the [http://mamp.info/ MAMP project page].

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

[[Image:Moodle4Mac_2.png|500px]]

'''Step 5:''' Double click the MAMP icon to start the server.

[[Image:Moodle4Mac_3.png|500px]]

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

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

[[Image:Moodle4Mac_4.png|900px]]

==Language packages==

By default Moodle4Mac is in English only; other languages must be installed. For example, you may want to switch your site to German. The German standard package ''de'' translates all text strings to German, the additional package ''de_du'' adds the informal conversation ''du'', the additional package ''de_kids'' provides scholastic simplifications.

Additional [[Language packs|language packs]] may be imported via ''Administration > Site administration > Language > Language packs''.

[[Image:Moodle4Mac_5.png|900px]]

After importing the additional language pack, the settings for the default language for the user account '''admin''' can be switched to German.

==Completely backup your server==
Just as you installed Moodle4Mac the first time on your computer, you can backup a customised system completely. Because all files and configurations are stored within the directory MAMP, you can easily backup your MAMP directory to an external disk. A snapshot of our Moodle site will be saved together with all settings and all the courses, and it can be recovered at any time in the same form.

First stop all server processes like httpd and mysqld, then exit the MAMP program. After everything has stopped you can copy or move the MAMP directory. If you want to transfer MAMP to one or more other computers, you need to create a ZIP archive containing the MAMP directory. This ZIP archive can be copied anywhere ... to an USB memory stick, to a web server, on a burned CD ...

The target computer must be a Mac. On this Mac, unpack the ZIP archive and move the MAMP folder to the Application folder ... done! Everything is going exactly as in the section download and installation. In this way you can prepare your Moodle for a presentation or a training lab, and then distribute it.

[[Image:Moodle4Mac_ZIP.png|500px]]

==Server in your local network==

In various workshops we used Moodle4Mac as a quick server installation for our local network. Make sure that you change the passwords for Moodle and MySQL before you allow access to this server ... otherwise, you'll be amazed how creative your user group can be. Please read the safety instructions of Moodle4Mac.

In this section you will see all required settings to use the server in the local network. Only three steps are required. The first step is to change one line in the config.php for Moodle. In the second step you need to adjust the base address in Moodle. And in your third step you open the firewall for ''httpd''.

To get your Moodle to another computer in your local network your Mac must be clearly addressable. You may use a fixed IP address or a DNS name. In local networks usually ip addresses of the private sections 10.xxx , 172.xxx , or 192.168.xx are assigned. If your Moodle4Mac gets an ip address this address must never change. Please do not use any static ip address if you do not know exactly what you do ... in case of doubt ask the administrator of the local network.

You can't use Moodle4Mac as a local server which is intended to work on different networks.

====Edit config.php====
For the following your computer should be a Mac in a computer lab. For this example it has the the fixed ip address 192.168.0.200. You must edit now the configuration ''/Applications/MAMP/htdocs/moodle24/config.php'' and change the wwwroot from ''localhost'' to ''192.168.0.200''. You must use your own address for your own network!!

After your changes you should get your Moodle with the address http://192.168.0.200/moodle24/

<pre><?php /// Moodle configuration file

unset($CFG);
global $CFG;
$CFG = new stdClass();

$CFG->dbtype = 'mysqli';
$CFG->dblibrary = 'native';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle28';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->prefix = 'mdl_';
$CFG->dboptions = array (
'dbpersit' => 0,
'dbport' => '',
'dbsocket' => 1,
);

// localhost wird auf 192.168.0.200 geändert
// $CFG->wwwroot = 'http://localhost:8888/moodle28';
$CFG->wwwroot = 'http://192.168.0.200:8888/moodle28';
$CFG->dataroot = '/Applications/MAMP/data/moodle28';
$CFG->admin = 'admin';

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

require_once(dirname(__FILE__) . '/lib/setup.php');

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

====Replace internal links in Moodle====
The original base address ''localhost'' is stored in many places within the database, your Moodle will not work properly with the modified base address. But images can not be displayed because they are accessible only from their correct address. From your local computer you might not see the problems but if you are outside on a computer getting access to the site.

Moodle has a tool that allows you to replace the database entries from http://localhost:8888/moodle24/ to http://192.168.0.200:8888/moodle28/ .

[[Image:Moodle4Mac_6.png|900px]]

You call this tool via the address http://192.168.0.200:8888/moodle28/admin/tool/replace/

No ... there is no menu option for it, probably because at thoughtless action with this tool also can shred the database ... in the first field enter http://localhost:8888/moodle28/, in the second field http://192.168.0.200:8888/moodle28/ (or the ip address that you have assigned in your installation). Use the correct spelling in both fields! With the hook you acknowledge that you know about the risk ...

====Open the firewall====
The firewall in OS X 10.6, 10.7, 10.8, and 10.9 can be enabled and disabled the ''System Preferences > Security > Firewall''. If the firewall is disabled, although Moodle4Mac works without further settings in the network, but your computer is vulnerable to all requests from the outside ... the latter you should not do!

[[Image:Moodle4Mac_Firewall1.png|520px]]

The the system firewall of OS X is a packet filter that determines for each program if a data packet should be passed or blocked. If the firewall is enabled every program must be entered on a list to respond to requests from outside. Moodle4Mac (or MAMP) uses the httpd program to deliver the sites. You will find httpd in the MAMP folder ... the path is ''/Application/MAMP/Library/bin/httpd''. To enter httpd into the whitelist of the firewall you must click forward on this path ... no idea if there would be a configuration file which you can edit.

You need to get this setting for the firewall only once. If httpd is approved then all computers in your local network can access to Moodle ... by the way it is not important which is used by httpd ... port 8888 or port 80.

Do not open the firewall for mysqld because Moodle itself gets a connection to mysql on the server but no user should communicate with mysql directly from the client.

[[Image:Moodle4Mac_Firewall2.png|520px]]

====Connect Moodle from your local network====
Your web server can be connected with the url http://192.168.0.200:8888/moodle28/ in your local network, where 192.168.0.200 is an example address which your Mac got from the local router. Usually such local numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x and you will be able to do your settings even if they differ from this description.

When you got all settings right then all users from any computer in your network will see your Moodle via http://192.168.0.200:8888/moodle28/. And there will be no problem with any operating system.

[[Image:Moodle4Mac_7.png|900px]]

====Connect Moodle from your local network with mobile devices====
The following images show the locale Moodle site with an iPad and an iPhone.

[[image:Moodle4Mac_8.png|890px]]

[[image:Moodle4Mac_9.png|490px]]

==Some words about the security ...==

====MAMP is not secure!====
MAMP can be used for testing and developing web sites locally on a Mac computer. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. MAMP is prepared for an easy start and not for a public web server!! But with some careful modifications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments. Be careful!

====How to secure MAMP?====
Moodle4Mac is a preconfigured package where all the default settings are accessible. The password for the Moodle admin user is known and must necessarily be changed.

But please do not think that this should be enough! Your Moodle could also be attacked through the back door via the database. You definitely need to change the passwords of the database users root and moodle, because these passwords are known. Otherwise any hacker could change the password of the user account admin to get full access to all the information in Moodle. Alternatively, the hacker could also assign another user account to full admin access and he would be able to read all informations ... the main admin would probably not notice of such a change. It is also possible to delete the database completely if you know the root access to the database so that all information could be lost in this case.

====Secure connections with HTTPS====
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (except for the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==
It is very simple to update your locally installed Moodle. You start the update with a double click and everything happens automatically. All courses rest in Moodle. You do not need to renew your local Moodle completely ... you only get the new Moodle files.

====Update the local Moodle via Git====
Make sure that the Git program is installed on your Mac (see instructions below). You also need an Internet connection because the files are downloaded from the Moodle update server. A double click on the icon UpdateMoodle.sh starts the script and updating occurs automatically. That's really all ... could it be easier?

[[Image:Moodle4Mac_Update1.png]]

The Git program connects to the Moodle server and controls which files are new, which have changed and which have been deleted. The transmission time depends on the internet connection. With Git only really necessary files will be transmitted. If the transfer takes too long, you can abort the process with <ctrl>-c. You can easily start the update again later.

[[Image:Moodle4Mac_Update2.png|550px]]

  

====Script control ... looking inside ... ====

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor, e.g. TextWrangler.

It is only a text file but it uses a OS X feature to open and execute the script with the Terminal program. You don't need to learn anything ... doubleclick to update everything.

<pre>
#! /bin/sh
#
# This GIT installer for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20150511 - Ralf Krause
#

echo
echo "+--------------------------------------------+"
echo "| GIT updater for your local Moodle server"
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs

if ! test -e moodle28/.git ; then
## the first git update must get everything including .git
git clone --depth 1 -b MOODLE_28_STABLE git://github.com/moodle/moodle.git moodle28-git
if test -e moodle28-git ; then
if test -e moodle28 ; then
if test -e moodle28/config.php ; then
cp moodle28/config.php moodle28-git/.
fi
DATE=`date +%Y%m%d-%H%M`
mv moodle28 moodle28-$DATE
fi
mv moodle28-git moodle28
fi
## the old folder can be deleted now
## if you want to do this please remove '##' from the following line
## sudo rm -R moodle28-*
else
## the next git update only gets the new files
cd moodle28
git pull
cd ..
fi
</pre>

The different versions of the script UpdateMoodle.sh only differ in two parameters ... first we need to know the right folder for Moodle and second we must use the correct git tag for the Moodle version. The shown script upgrades Moodle 2.8.
* Moodle 2.7 uses MOODLE_27_STABLE
* Moodle 2.8 uses MOODLE_28_STABLE
* Moodle 2.9 uses MOODLE_29_STABLE
* Moodle 3.0 uses MOODLE_30_STABLE
* Moodle 3.1 uses MOODLE_31_STABLE
* Moodle 3.2dev uses master

====Install Git====

Download the Git program from http://git-scm.com/download/ ... it's free and open source.

[[Image:Moodle4Mac_Git1.png]]
  

Open the disk image and doubleclick the installer git-xxx-osx.pkg. If you want to know more about Git then read the Git documentation on their web site ... but if you only want to update Moodle the script '''UpdateMoodle.sh''' should also work without reading

[[Image:Moodle4Mac_Git2.png|500px]]
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [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]

[[Category:Mac OS X]]

[[de:Installationspaket für OS X]]
[[es:Paquetes de Instalación Completos para Mac OS X]]

Installation Package for OS X

2016-05-24T08:01:28Z

Krause: /* Script control ... looking inside ... */

{{Installing Moodle}}
==Summary==
The complete install packages for Mac OS X are named Moodle4Mac and allow a very easy way to install Moodle on your Mac computer (laptop, desktop or test server). Moodle4Mac is available from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X].

Moodle4Mac is based on the software MAMP. MAMP contains everything that is necessary for the operation of Moodle - the Apache web server, MySQL database and PHP scripting language. Packages are available for different Moodle versions. Please check which Moodle your institution (school, college, university, company) uses on its server so that you can swap your materials between the two platforms easily.

You can also install the latest Moodle development version to find everything about upcoming opportunities and changes. However, please remember that a developer version is not yet a finished product, and thus may contain errors.

Moodle4Mac packages also include a special Git update script, enabling you to easily update your Moodle site without needing to download the whole package again and without reinstalling all your courses.

Note: Moodle4Mac is NOT intended to be used for a production server on the Internet. It is only intended for installation on a local computer to test and develop, as it is not optimized for security.

==System requirements==
+ Apple OS X Computer
+ iMac, Mac mini, MacBook, MacBook Air, Mac Pro
+ Processor: Intel x86_64 (i5, i7, Xeon, Core2Duo)
+ RAM: 4 GB or better
+ Hard Disk: 1 GB free
+ System Software: OS X 10.6.8, 10.7, 10.8, 10.9, 10.10

==Download and install ==
'''Step 1:''' Download the disk image '''Moodle4Mac-MAMP.dmg''' from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X] . You will find various image files for the different Moodle versions.

'''Step 2:''' Double click the disk image '''Moodle4Mac-MAMP.dmg''' to mount the installation disk.

[[Image:Moodle4Mac_1.png|500px]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac OS X, Apache, MySQL, PHP). MAMP does not save parameters in a registry or in system variables. If you want to delete Moodle4Mac you only need to move the MAMP folder into the Trash. For more information about MAMP please look at the [http://mamp.info/ MAMP project page].

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

[[Image:Moodle4Mac_2.png|500px]]

'''Step 5:''' Double click the MAMP icon to start the server.

[[Image:Moodle4Mac_3.png|500px]]

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

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

[[Image:Moodle4Mac_4.png|900px]]

==Language packages==

By default Moodle4Mac is in English only; other languages must be installed. For example, you may want to switch your site to German. The German standard package ''de'' translates all text strings to German, the additional package ''de_du'' adds the informal conversation ''du'', the additional package ''de_kids'' provides scholastic simplifications.

Additional [[Language packs|language packs]] may be imported via ''Administration > Site administration > Language > Language packs''.

[[Image:Moodle4Mac_5.png|900px]]

After importing the additional language pack, the settings for the default language for the user account '''admin''' can be switched to German.

==Completely backup your server==
Just as you installed Moodle4Mac the first time on your computer, you can backup a customised system completely. Because all files and configurations are stored within the directory MAMP, you can easily backup your MAMP directory to an external disk. A snapshot of our Moodle site will be saved together with all settings and all the courses, and it can be recovered at any time in the same form.

First stop all server processes like httpd and mysqld, then exit the MAMP program. After everything has stopped you can copy or move the MAMP directory. If you want to transfer MAMP to one or more other computers, you need to create a ZIP archive containing the MAMP directory. This ZIP archive can be copied anywhere ... to an USB memory stick, to a web server, on a burned CD ...

The target computer must be a Mac. On this Mac, unpack the ZIP archive and move the MAMP folder to the Application folder ... done! Everything is going exactly as in the section download and installation. In this way you can prepare your Moodle for a presentation or a training lab, and then distribute it.

[[Image:Moodle4Mac_ZIP.png|500px]]

==Server in your local network==

In various workshops we used Moodle4Mac as a quick server installation for our local network. Make sure that you change the passwords for Moodle and MySQL before you allow access to this server ... otherwise, you'll be amazed how creative your user group can be. Please read the safety instructions of Moodle4Mac.

In this section you will see all required settings to use the server in the local network. Only three steps are required. The first step is to change one line in the config.php for Moodle. In the second step you need to adjust the base address in Moodle. And in your third step you open the firewall for ''httpd''.

To get your Moodle to another computer in your local network your Mac must be clearly addressable. You may use a fixed IP address or a DNS name. In local networks usually ip addresses of the private sections 10.xxx , 172.xxx , or 192.168.xx are assigned. If your Moodle4Mac gets an ip address this address must never change. Please do not use any static ip address if you do not know exactly what you do ... in case of doubt ask the administrator of the local network.

You can't use Moodle4Mac as a local server which is intended to work on different networks.

====Edit config.php====
For the following your computer should be a Mac in a computer lab. For this example it has the the fixed ip address 192.168.0.200. You must edit now the configuration ''/Applications/MAMP/htdocs/moodle24/config.php'' and change the wwwroot from ''localhost'' to ''192.168.0.200''. You must use your own address for your own network!!

After your changes you should get your Moodle with the address http://192.168.0.200/moodle24/

<pre><?php /// Moodle configuration file

unset($CFG);
global $CFG;
$CFG = new stdClass();

$CFG->dbtype = 'mysqli';
$CFG->dblibrary = 'native';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle28';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->prefix = 'mdl_';
$CFG->dboptions = array (
'dbpersit' => 0,
'dbport' => '',
'dbsocket' => 1,
);

// localhost wird auf 192.168.0.200 geändert
// $CFG->wwwroot = 'http://localhost:8888/moodle28';
$CFG->wwwroot = 'http://192.168.0.200:8888/moodle28';
$CFG->dataroot = '/Applications/MAMP/data/moodle28';
$CFG->admin = 'admin';

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

require_once(dirname(__FILE__) . '/lib/setup.php');

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

====Replace internal links in Moodle====
The original base address ''localhost'' is stored in many places within the database, your Moodle will not work properly with the modified base address. But images can not be displayed because they are accessible only from their correct address. From your local computer you might not see the problems but if you are outside on a computer getting access to the site.

Moodle has a tool that allows you to replace the database entries from http://localhost:8888/moodle24/ to http://192.168.0.200:8888/moodle28/ .

[[Image:Moodle4Mac_6.png|900px]]

You call this tool via the address http://192.168.0.200:8888/moodle28/admin/tool/replace/

No ... there is no menu option for it, probably because at thoughtless action with this tool also can shred the database ... in the first field enter http://localhost:8888/moodle28/, in the second field http://192.168.0.200:8888/moodle28/ (or the ip address that you have assigned in your installation). Use the correct spelling in both fields! With the hook you acknowledge that you know about the risk ...

====Open the firewall====
The firewall in OS X 10.6, 10.7, 10.8, and 10.9 can be enabled and disabled the ''System Preferences > Security > Firewall''. If the firewall is disabled, although Moodle4Mac works without further settings in the network, but your computer is vulnerable to all requests from the outside ... the latter you should not do!

[[Image:Moodle4Mac_Firewall1.png|520px]]

The the system firewall of OS X is a packet filter that determines for each program if a data packet should be passed or blocked. If the firewall is enabled every program must be entered on a list to respond to requests from outside. Moodle4Mac (or MAMP) uses the httpd program to deliver the sites. You will find httpd in the MAMP folder ... the path is ''/Application/MAMP/Library/bin/httpd''. To enter httpd into the whitelist of the firewall you must click forward on this path ... no idea if there would be a configuration file which you can edit.

You need to get this setting for the firewall only once. If httpd is approved then all computers in your local network can access to Moodle ... by the way it is not important which is used by httpd ... port 8888 or port 80.

Do not open the firewall for mysqld because Moodle itself gets a connection to mysql on the server but no user should communicate with mysql directly from the client.

[[Image:Moodle4Mac_Firewall2.png|520px]]

====Connect Moodle from your local network====
Your web server can be connected with the url http://192.168.0.200:8888/moodle28/ in your local network, where 192.168.0.200 is an example address which your Mac got from the local router. Usually such local numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x and you will be able to do your settings even if they differ from this description.

When you got all settings right then all users from any computer in your network will see your Moodle via http://192.168.0.200:8888/moodle28/. And there will be no problem with any operating system.

[[Image:Moodle4Mac_7.png|900px]]

====Connect Moodle from your local network with mobile devices====
The following images show the locale Moodle site with an iPad and an iPhone.

[[image:Moodle4Mac_8.png|890px]]

[[image:Moodle4Mac_9.png|490px]]

==Some words about the security ...==

====MAMP is not secure!====
MAMP can be used for testing and developing web sites locally on a Mac computer. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. MAMP is prepared for an easy start and not for a public web server!! But with some careful modifications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments. Be careful!

====How to secure MAMP?====
Moodle4Mac is a preconfigured package where all the default settings are accessible. The password for the Moodle admin user is known and must necessarily be changed.

But please do not think that this should be enough! Your Moodle could also be attacked through the back door via the database. You definitely need to change the passwords of the database users root and moodle, because these passwords are known. Otherwise any hacker could change the password of the user account admin to get full access to all the information in Moodle. Alternatively, the hacker could also assign another user account to full admin access and he would be able to read all informations ... the main admin would probably not notice of such a change. It is also possible to delete the database completely if you know the root access to the database so that all information could be lost in this case.

====Secure connections with HTTPS====
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (except for the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==
It is very simple to update your locally installed Moodle. You start the update with a double click and everything happens automatically. All courses rest in Moodle. You do not need to renew your local Moodle completely ... you only get the new Moodle files.

====Update the local Moodle via Git====
Make sure that the Git program is installed on your Mac (see instructions below). You also need an Internet connection because the files are downloaded from the Moodle update server. A double click on the icon UpdateMoodle.sh starts the script and updating occurs automatically. That's really all ... could it be easier?

[[Image:Moodle4Mac_Update1.png]]

The Git program connects to the Moodle server and controls which files are new, which have changed and which have been deleted. The transmission time depends on the internet connection. With Git only really necessary files will be transmitted. If the transfer takes too long, you can abort the process with <ctrl>-c. You can easily start the update again later.

[[Image:Moodle4Mac_Update2.png|550px]]

  

====Script control ... looking inside ... ====

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor, e.g. TextWrangler.

It is only a text file but it uses a OS X feature to open and execute the script with the Terminal program. You don't need to learn anything ... doubleclick to update everything.

<pre>
#! /bin/sh
#
# This GIT installer for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20150511 - Ralf Krause
#

echo
echo "+--------------------------------------------+"
echo "| GIT updater for your local Moodle server"
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs

if ! test -e moodle28/.git ; then
## the first git update must get everything including .git
git clone --depth 1 -b MOODLE_28_STABLE git://github.com/moodle/moodle.git moodle28-git
if test -e moodle28-git ; then
if test -e moodle28 ; then
if test -e moodle28/config.php ; then
cp moodle28/config.php moodle28-git/.
fi
DATE=`date +%Y%m%d-%H%M`
mv moodle28 moodle28-$DATE
fi
mv moodle28-git moodle28
fi
## the old folder can be deleted now
## if you want to do this please remove '##' from the following line
## sudo rm -R moodle28-*
else
## the next git update only gets the new files
cd moodle28
git pull
cd ..
fi
</pre>

The different versions of the script UpdateMoodle.sh only differ in two parameters ... first we need to know the right folder for Moodle and second we must use the correct git tag for the Moodle version. The shown script upgrades Moodle 2.8.
* Moodle 2.7 uses MOODLE_27_STABLE
* Moodle 2.8 uses MOODLE_28_STABLE
* Moodle 2.9 uses MOODLE_29_STABLE
* Moodle 3.0 uses MOODLE_30_STABLE
* Moodle 3.1 uses MOODLE_31_STABLE
* Moodle 3.2dev uses master

====Install Git====

Download the Git program from http://git-scm.com/download/ ... it's free and open source.

[[Image:Moodle4Mac_Git1.png]]
  

Open the disk image and doubleclick the installer git-xxx-osx.pkg. If you want to know more about Git then read the Git documentation on their web site ... but if you only want to update Moodle the script '''UpdateMoodle.sh''' should also work without reading

[[Image:Moodle4Mac_Git2.png|500px]]
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [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]

[[Category:Mac OS X]]

[[de:Installationspaket für OS X]]
[[es:Paquetes de Instalación Completos para Mac OS X]]

Moodle app FAQ

2015-07-26T09:23:45Z

Krause:

{{Mobile}}
== How can I use Moodle on mobile devices? ==
There are currently 3 main ways to use Moodle on mobile devices:

* Users can open Moodle sites in their mobile web browsers.
* Users can download native apps for their mobile devices.
* Admins can configure their Moodle site to be Mobile-accessible through server extensions.

=== Mobile Apps ===
* The official [[Mobile app]] developed by Juan Leyva with support from Jerome Mouneyrac, Moodle HQ and others.
* [http://www.moodletouch.com MoodleTouch] (aka ''mTouch'') for iOS, created by Ali OzGur
* [http://mpage.hk/ mPage] for iOS and Android (work in progress), created by Mass Media HK
* [http://codeguild.org/app/mbot/ Mbot] for Android, created by Code Guild
* The [https://docs.moodle.org/23/en/Mobile_app My Moodle app] for iPhone, created by Moodle HQ (no longer being developed)
* [https://market.android.com/details?id=com.ivoid.droodle Droodle] - an Android client for the Moodle 2.1 platform

=== Server-side ===
* [http://www.mobilemoodle.org/momo18/ MoMo] (Moodle for Mobiles) - Requires a server extension and a client app; supports most mobile OSes including Symbian.
* [http://code.google.com/p/moodbile/ Moodbile] - Reference implementation of Moodle Web Services. Under development.
* [http://iphone.moodle.com.au iPhone4Moodle] - Under development.

==Where can I download the official Mobile app? ==

Please, visit https://download.moodle.org/mobile/ for download links

==How do I get the official Mobile app to work for my Moodle site?==

Firstly, your Moodle site must be using Moodle 2.4 or later.

Secondly mobile web services must be enabled. See [[Enable mobile web services]] for details.

==Where can I select a theme for mobile devices?==

In ''Site administration > Appearance > Themes > Theme selector''.

New in Moodle 2.2 onwards is the MyMobile theme especially designed for mobile devices.

== I can't access my Moodle site using the app ==

Notice that by default Mobile access is disabled in Moodle. The administrator of your Moodle site (which must be version 2.4 or later) must enable mobile access.

Authentication methods like Shibboleth, CAS or LDAP/SSO are supported only using a Moodle add-one (See [[Moodle Mobile additional features]])

You should verify also that Debugging and "Display debug messages" are disabled in your site (go to Administration / Development / Debugging for checking that options)

If your site uses a SSL certificate it must be a trusted certificate. For security reasons the app doesn't work with self-signed certificates. There are some certificates entities that provides certificates not trusted by the Android browser (but trusted in desktop browsers) like GoDaddy and TERENA SSL CA. Here you can find a workaround/solution: https://moodle.org/mod/forum/discuss.php?d=268963#p1172128

== Moodle Mobile app says I need 2.4 or higher ==

The administrator of your Moodle site (which must be version 2.4 or later) must enable mobile access as follows:

In Site administration > Plugins > Web services > Mobile tick the 'Enable web services for mobile devices' checkbox, then click the button to save changes.

Some Moodle sites uses special authentication methods like Shibboleth, CAS or LDAP/SSO that currently are not supported. See https://tracker.moodle.org/browse/MOBILE-113 for more information.

==I can't view the courses tab as an administrator==
Moodle Mobile app is not suited for administrators ad the app displays only the courses you are enrolled in (not the courses you can see by capabilities).Note that the targeted user of the app is mainly a student or teacher.If you want to see the courses as an admin, you must be enrolled in the courses. You can use a non visible role or something similar.

== What happened to the Mobile app remote translation feature? ==

Remote translation is not available any more; this feature was removed because due to core changes in Moodle it never worked as expected.

Language packs comes now with the app bundle. If you want to contribute a translation of the app you can do so on the [http://lang.moodle.org Moodle translation site]. The component name is local_moodlemobileapp. See the forum discussion [https://moodle.org/mod/forum/discuss.php?d=252704 Moodle Mobile translation to other languages] for more details.

== I got the "we lost connection, you need to reconnect. Your token is now invalid." on my custom version of Moodle Mobile ==

Please, verify that you have followed all the steps here: https://docs.moodle.org/dev/Moodle_Mobile_Developing_a_plugin_tutorial#Set_up_your_Moodle_installation

And also that you have enabled the moodle/webservice:createtoken capability for the Authenticated User Role at System Context

== I got the error "Automatically token generation is not available to site administrators" ==

This can be easily solved, administrators must create a token manually in Moodle (Plugins > Web Services > Manage tokens) for the local_mobile service.

==See also==

* [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum]
* Tracker area [http://tracker.moodle.org/browse/MOBILE Moodle for Mobiles]
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=162872 Proposal for Supporting Mobile Themes and Browser Detection] forum discussion
* An open course, about "[http://tempus-efa.proj.ac.il/moodle/course/view.php?id=102 Teaching using Mobile - Best practices]"
* [http://www.moodlenews.com/mobile/ Moodle News - Mobile] - a breakdown of the mobile projects and products available

[[Category:FAQ]]

[[de:Moodle Mobile FAQ]]
[[es:Moodle para móviles FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Installation Package for OS X

2015-05-18T07:34:22Z

Krause: /* System requirements */

{{Installing Moodle}}
==Summary==
The complete install packages for Mac OS X are named Moodle4Mac and allow a very easy way to install Moodle on your Mac computer (laptop, desktop, server). Moodle4Mac is available from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X]. You will find other downloads for Linux and Window Operating Systems that may involve more customization of configuration files.

Moodle4Mac is based on the software MAMP. MAMP contains everything that is necessary for the operation of Moodle, the Apache web server, MySQL database and PHP scripting language. For the various Moodle versions you can get different installation packages. Please check which Moodle your institution (school, college, university, company) uses on its server so that you can swap your materials between the two platforms easily.

Of course, you can install the latest Moodle development version to find everything about upcoming opportunities and changes. However, please remember that a developer version is not yet a finished product, and that a development version may contain errors.

Moodle4Mac is not intended to be used as a productive server on the Internet. It is only intended for installation on a local computer to test and develop. The configuration is not optimized for security. If you want to run Moodle on an OS X server connected to the internet, please read the instructions [https://docs.moodle.org/en/Step_by_Step_Installation_on_a_Mac_OS_X_Server Step by step installation on a OS X Server].

==System requirements==
+ Apple OS X Computer
+ iMac, Mac mini, MacBook, MacBook Air, Mac Pro
+ Processor: Intel x86_64 (i5, i7, Xeon, Core2Duo)
+ RAM: 4 GB or better
+ Hard Disk: 1 GB free
+ System Software: OS X 10.6.8, 10.7, 10.8, 10.9, 10.10

==Download and install ==
'''Step 1:''' Download the disk image '''Moodle4Mac-MAMP.dmg''' from the web site [http://download.moodle.org/macosx/ Moodle packages for Mac OS X] . You will find various image files for the different Moodle versions on this web site.

'''Step 2:''' Double click the disk image '''Moodle4Mac-MAMP.dmg''' to mount the installation disk.

[[Image:Moodle4Mac_1.png|500px]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac OS X, Apache, MySQL, PHP). MAMP does not save parameters in a registry or in system variables. If you want to delete Moodle4Mac you only need to move the MAMP folder into the Trash. For more information about MAMP please look at the [http://mamp.info/ MAMP project page].

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

[[Image:Moodle4Mac_2.png|500px]]

'''Step 5:''' Double click the MAMP icon to start the server.

[[Image:Moodle4Mac_3.png|500px]]

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

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

[[Image:Moodle4Mac_4.png|900px]]

==Language packages==

By default Moodle4Mac is delivered in English, any other language must be loaded. The german standard package ''de'' translates all text strings to german, the additional package ''de_du'' adds the informal conversation ''du'', the additional package ''de_kids'' provides scholastic simplifications.

The direct link for the language import is http://localhost:8888/moodle28/admin/tool/langimport/

[[Image:Moodle4Mac_5.png|900px]]

After importing the additional language pack, the settings for the default language for the user account '''admin''' can be switched to German. Only it you change the setting you will find the german menus and german settings dialogs your Moodle. Of course, all text in the text boxes on the home page and in the two preloaded courses Moodle4Mac About and How to update as they were originally entered ... if you like, you can change these texts like ....

==Completely backup your server==
Just as you installed Moodle4Mac the first time on your computer, you can backup a customized system completely. Because all files and configurations are stored within the directory MAMP, you can easily backup your MAMP directory to an external disk. Your Moodle will be frozen together with all settings and all the courses, and it can be recovered at any time in the same form.

First stop all server processes like httpd and mysqld, then exit the MAMP program. After everything stopped you can copy or move the MAMP directory. If you want to transfer MAMP to one or more other computers, you will create a ZIP archive containing the MAMP directory. This ZIP archive can be copied anywhere ... to an USB memory, to a web server, on a burned CD ...

The target computer must be a Mac. On this Mac, unpack the ZIP archive and move the MAMP folder to the Application folder ... done! Everything is going exactly as in section download and installation. In this way you can prepare your Moodle for a presentation or a training lab, and you can distribute it.

[[Image:Moodle4Mac_ZIP.png|500px]]

==Server in your local network==

In various workshops we used Moodle4Mac as a quick server installation for our local network. Make sure that you change the passwords for Moodle and MySQL before you allow access to this server ... otherwise, you'll be amazed how creative your user group can be. Please read the safety instructions of Moodle4Mac.

In this section you will see all required settings to use the server in the local network. Only three steps are required. The first step is to change one line in the config.php for Moodle. In the second step you need to adjust the base address in Moodle. And in your third step you open the firewall for ''httpd''.

To get your Moodle to another computer in your local network your Mac must be clearly addressable. You may use a fixed IP address or a DNS name. In local networks usually ip addresses of the private sections 10.xxx , 172.xxx , or 192.168.xx are assigned. If your Moodle4Mac gets an ip address this address must never change. Please do not use any static ip address if you do not know exactly what you do ... in case of doubt ask the administrator of the local network.

You can't use Moodle4Mac as a local server which is intended to work on different networks.

====Edit config.php====
For the following your computer should be a Mac in a computer lab. For this example it has the the fixed ip address 192.168.0.200. You must edit now the configuration ''/Applications/MAMP/htdocs/moodle24/config.php'' and change the wwwroot from ''localhost'' to ''192.168.0.200''. You must use your own address for your own network!!

After your changes you should get your Moodle with the address http://192.168.0.200/moodle24/

<pre><?php /// Moodle configuration file

unset($CFG);
global $CFG;
$CFG = new stdClass();

$CFG->dbtype = 'mysqli';
$CFG->dblibrary = 'native';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle28';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->prefix = 'mdl_';
$CFG->dboptions = array (
'dbpersit' => 0,
'dbport' => '',
'dbsocket' => 1,
);

// localhost wird auf 192.168.0.200 geändert
// $CFG->wwwroot = 'http://localhost:8888/moodle28';
$CFG->wwwroot = 'http://192.168.0.200:8888/moodle28';
$CFG->dataroot = '/Applications/MAMP/data/moodle28';
$CFG->admin = 'admin';

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

require_once(dirname(__FILE__) . '/lib/setup.php');

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

====Replace internal links in Moodle====
The original base address ''localhost'' is stored in many places within the database, your Moodle will not work properly with the modified base address. But images can not be displayed because they are accessible only from their correct address. From your local computer you might not see the problems but if you are outside on a computer getting access to the site.

Moodle has a tool that allows you to replace the database entries from http://localhost:8888/moodle24/ to http://192.168.0.200:8888/moodle28/ .

[[Image:Moodle4Mac_6.png|900px]]

You call this tool via the address http://192.168.0.200:8888/moodle28/admin/tool/replace/

No ... there is no menu option for it, probably because at thoughtless action with this tool also can shred the database ... in the first field enter http://localhost:8888/moodle28/, in the second field http://192.168.0.200:8888/moodle28/ (or the ip address that you have assigned in your installation). Use the correct spelling in both fields! With the hook you acknowledge that you know about the risk ...

====Open the firewall====
The firewall in OS X 10.6, 10.7, 10.8, and 10.9 can be enabled and disabled the ''System Preferences > Security > Firewall''. If the firewall is disabled, although Moodle4Mac works without further settings in the network, but your computer is vulnerable to all requests from the outside ... the latter you should not do!

[[Image:Moodle4Mac_Firewall1.png|520px]]

The the system firewall of OS X is a packet filter that determines for each program if a data packet should be passed or blocked. If the firewall is enabled every program must be entered on a list to respond to requests from outside. Moodle4Mac (or MAMP) uses the httpd program to deliver the sites. You will find httpd in the MAMP folder ... the path is ''/Application/MAMP/Library/bin/httpd''. To enter httpd into the whitelist of the firewall you must click forward on this path ... no idea if there would be a configuration file which you can edit.

You need to get this setting for the firewall only once. If httpd is approved then all computers in your local network can access to Moodle ... by the way it is not important which is used by httpd ... port 8888 or port 80.

Do not open the firewall for mysqld because Moodle itself gets a connection to mysql on the server but no user should communicate with mysql directly from the client.

[[Image:Moodle4Mac_Firewall2.png|520px]]

====Connect Moodle from your local network====
Your web server can be connected with the url http://192.168.0.200:8888/moodle28/ in your local network, where 192.168.0.200 is an example address which your Mac got from the local router. Usually such local numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x and you will be able to do your settings even if they differ from this description.

When you got all settings right then all users from any computer in your network will see your Moodle via http://192.168.0.200:8888/moodle28/. And there will be no problem with any operating system.

[[Image:Moodle4Mac_7.png|900px]]

====Connect Moodle from your local network with mobile devices====
The following images show the locale Moodle site with an iPad and an iPhone.

[[image:Moodle4Mac_8.png|890px]]

[[image:Moodle4Mac_9.png|490px]]

==Some words about the security ...==
====MAMP is not secure!====
MAMP can be used for testing and developing web sites locally on a Mac computer. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. MAMP is prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments. Be careful!

====How to secure MAMP?====
Moodle4Mac is a preconfigured package where all the default settings are accessible. The password for the Moodle admin user is known and must necessarily be changed.

But please do not think that this should be enough! Your Moodle could also be attacked through the back door via the database. You definitely need to change the passwords of the database users root and moodle, because these passwords are known. Otherwise any hacker could change the password of the user account admin to get full access to all the information in Moodle. Alternatively, the hacker could also assign another user account to full admin access and he would be able to read all informations ... the main admin would probably not notice of such a change. It is also possible to delete the database completely if you know the root access to the database so that all information could be lost in this case.

====Secure connections with HTTPS====
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==
It is very simple to update your locally installed Moodle. You start the update with a double click and everything happens automatically. All courses rest in Moodle. You do not need to renew your local Moodle completely ... you only get the new Moodle files.

====Update the local Moodle via Git====
Make sure that the Git program is installed on your Mac (see instructions below). You also need an Internet connection because the files are downloaded from the Moodle update server. A double click on the icon UpdateMoodle.sh starts the script and updating occurs automatically. That's really all ... could it be easier?

[[Image:Moodle4Mac_Update1.png]]

The Git program connects to the Moodle server and controls which files are new, which have changed and which have been deleted. The transmission time depends on the internet connection. With Git only really necessary files will be transmitted. If the transfer takes too long, you can abort the process with <ctrl>-c. You can easily start the update again later.

[[Image:Moodle4Mac_Update2.png|550px]]

  

====Script control ... looking inside ... ====

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor, e.g. TextWrangler.

It is only a text file but it uses a OS X feature to open and execute the script with the Terminal program. You don't need to learn anything ... doubleclick to update everything.

<pre>
#! /bin/sh
#
# This GIT installer for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20150511 - Ralf Krause
#

echo
echo "+--------------------------------------------+"
echo "| GIT updater for your local Moodle server"
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs

if ! test -e moodle28/.git ; then
## the first git update must get everything including .git
git clone --depth 1 -b MOODLE_28_STABLE git://github.com/moodle/moodle.git moodle28-git
if test -e moodle28-git ; then
if test -e moodle28 ; then
if test -e moodle28/config.php ; then
cp moodle28/config.php moodle28-git/.
fi
DATE=`date +%Y%m%d-%H%M`
mv moodle28 moodle28-$DATE
fi
mv moodle28-git moodle28
fi
## the old folder can be deleted now
## if you want to do this please remove '##' from the following line
## sudo rm -R moodle28-*
else
## the next git update only gets the new files
cd moodle28
git pull
cd ..
fi
</pre>

The different versions of the script UpdateMoodle.sh only differ in two parameters ... first we need to know the right folder for Moodle and second we must use the correct git tag for the Moodle version. The shown script upgrades Moodle 2.8.
* Moodle 2.0 uses MOODLE_20_STABLE
* Moodle 2.1 uses MOODLE_21_STABLE
* Moodle 2.2 uses MOODLE_22_STABLE
* Moodle 2.3 uses MOODLE_23_STABLE
* Moodle 2.4 uses MOODLE_24_STABLE
* Moodle 2.5 uses MOODLE_25_STABLE
* Moodle 2.6 uses MOODLE_26_STABLE
* Moodle 2.7 uses MOODLE_27_STABLE
* Moodle 2.8 uses MOODLE_28_STABLE
* Moodle 2.9 uses MOODLE_29_STABLE
* Moodle 3.0dev uses master

====Install Git====

Download the Git program from http://git-scm.com/download/ ... it's free and open source.

[[Image:Moodle4Mac_Git1.png]]
  

Open the disk image and doubleclick the installer git-xxx-osx.pkg. If you want to know more about Git then read the Git documentation on their web site ... but if you only want to update Moodle the script '''UpdateMoodle.sh''' should also work without reading

[[Image:Moodle4Mac_Git2.png|500px]]
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [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]

[[Category:Mac OS X]]

[[de:Installationspaket für OS X]]
[[es:Paquetes de Instalación Completos para Mac OS X]]

Installation Package for OS X

2015-05-18T07:31:51Z

Krause: /* Script control ... looking inside ... */

{{Installing Moodle}}
==Summary==
The complete install packages for Mac OS X are named Moodle4Mac and allow a very easy way to install Moodle on your Mac computer (laptop, desktop, server). Moodle4Mac is available from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X]. You will find other downloads for Linux and Window Operating Systems that may involve more customization of configuration files.

Moodle4Mac is based on the software MAMP. MAMP contains everything that is necessary for the operation of Moodle, the Apache web server, MySQL database and PHP scripting language. For the various Moodle versions you can get different installation packages. Please check which Moodle your institution (school, college, university, company) uses on its server so that you can swap your materials between the two platforms easily.

Of course, you can install the latest Moodle development version to find everything about upcoming opportunities and changes. However, please remember that a developer version is not yet a finished product, and that a development version may contain errors.

Moodle4Mac is not intended to be used as a productive server on the Internet. It is only intended for installation on a local computer to test and develop. The configuration is not optimized for security. If you want to run Moodle on an OS X server connected to the internet, please read the instructions [https://docs.moodle.org/en/Step_by_Step_Installation_on_a_Mac_OS_X_Server Step by step installation on a OS X Server].

==System requirements==
+ Apple OS X Computer
+ iMac, Mac mini, MacBook, MacBook Air, Mac Pro
+ Processor: Intel x86_64 (i5, i7, Xeon, Core2Duo)
+ RAM: 4 GB or better
+ Hard Disk: 1 GB free
+ System Software: OS X 10.6, 10.7, 10.8, 10.9, 10.10

==Download and install ==
'''Step 1:''' Download the disk image '''Moodle4Mac-MAMP.dmg''' from the web site [http://download.moodle.org/macosx/ Moodle packages for Mac OS X] . You will find various image files for the different Moodle versions on this web site.

'''Step 2:''' Double click the disk image '''Moodle4Mac-MAMP.dmg''' to mount the installation disk.

[[Image:Moodle4Mac_1.png|500px]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac OS X, Apache, MySQL, PHP). MAMP does not save parameters in a registry or in system variables. If you want to delete Moodle4Mac you only need to move the MAMP folder into the Trash. For more information about MAMP please look at the [http://mamp.info/ MAMP project page].

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

[[Image:Moodle4Mac_2.png|500px]]

'''Step 5:''' Double click the MAMP icon to start the server.

[[Image:Moodle4Mac_3.png|500px]]

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

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

[[Image:Moodle4Mac_4.png|900px]]

==Language packages==

By default Moodle4Mac is delivered in English, any other language must be loaded. The german standard package ''de'' translates all text strings to german, the additional package ''de_du'' adds the informal conversation ''du'', the additional package ''de_kids'' provides scholastic simplifications.

The direct link for the language import is http://localhost:8888/moodle28/admin/tool/langimport/

[[Image:Moodle4Mac_5.png|900px]]

After importing the additional language pack, the settings for the default language for the user account '''admin''' can be switched to German. Only it you change the setting you will find the german menus and german settings dialogs your Moodle. Of course, all text in the text boxes on the home page and in the two preloaded courses Moodle4Mac About and How to update as they were originally entered ... if you like, you can change these texts like ....

==Completely backup your server==
Just as you installed Moodle4Mac the first time on your computer, you can backup a customized system completely. Because all files and configurations are stored within the directory MAMP, you can easily backup your MAMP directory to an external disk. Your Moodle will be frozen together with all settings and all the courses, and it can be recovered at any time in the same form.

First stop all server processes like httpd and mysqld, then exit the MAMP program. After everything stopped you can copy or move the MAMP directory. If you want to transfer MAMP to one or more other computers, you will create a ZIP archive containing the MAMP directory. This ZIP archive can be copied anywhere ... to an USB memory, to a web server, on a burned CD ...

The target computer must be a Mac. On this Mac, unpack the ZIP archive and move the MAMP folder to the Application folder ... done! Everything is going exactly as in section download and installation. In this way you can prepare your Moodle for a presentation or a training lab, and you can distribute it.

[[Image:Moodle4Mac_ZIP.png|500px]]

==Server in your local network==

In various workshops we used Moodle4Mac as a quick server installation for our local network. Make sure that you change the passwords for Moodle and MySQL before you allow access to this server ... otherwise, you'll be amazed how creative your user group can be. Please read the safety instructions of Moodle4Mac.

In this section you will see all required settings to use the server in the local network. Only three steps are required. The first step is to change one line in the config.php for Moodle. In the second step you need to adjust the base address in Moodle. And in your third step you open the firewall for ''httpd''.

To get your Moodle to another computer in your local network your Mac must be clearly addressable. You may use a fixed IP address or a DNS name. In local networks usually ip addresses of the private sections 10.xxx , 172.xxx , or 192.168.xx are assigned. If your Moodle4Mac gets an ip address this address must never change. Please do not use any static ip address if you do not know exactly what you do ... in case of doubt ask the administrator of the local network.

You can't use Moodle4Mac as a local server which is intended to work on different networks.

====Edit config.php====
For the following your computer should be a Mac in a computer lab. For this example it has the the fixed ip address 192.168.0.200. You must edit now the configuration ''/Applications/MAMP/htdocs/moodle24/config.php'' and change the wwwroot from ''localhost'' to ''192.168.0.200''. You must use your own address for your own network!!

After your changes you should get your Moodle with the address http://192.168.0.200/moodle24/

<pre><?php /// Moodle configuration file

unset($CFG);
global $CFG;
$CFG = new stdClass();

$CFG->dbtype = 'mysqli';
$CFG->dblibrary = 'native';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle28';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->prefix = 'mdl_';
$CFG->dboptions = array (
'dbpersit' => 0,
'dbport' => '',
'dbsocket' => 1,
);

// localhost wird auf 192.168.0.200 geändert
// $CFG->wwwroot = 'http://localhost:8888/moodle28';
$CFG->wwwroot = 'http://192.168.0.200:8888/moodle28';
$CFG->dataroot = '/Applications/MAMP/data/moodle28';
$CFG->admin = 'admin';

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

require_once(dirname(__FILE__) . '/lib/setup.php');

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

====Replace internal links in Moodle====
The original base address ''localhost'' is stored in many places within the database, your Moodle will not work properly with the modified base address. But images can not be displayed because they are accessible only from their correct address. From your local computer you might not see the problems but if you are outside on a computer getting access to the site.

Moodle has a tool that allows you to replace the database entries from http://localhost:8888/moodle24/ to http://192.168.0.200:8888/moodle28/ .

[[Image:Moodle4Mac_6.png|900px]]

You call this tool via the address http://192.168.0.200:8888/moodle28/admin/tool/replace/

No ... there is no menu option for it, probably because at thoughtless action with this tool also can shred the database ... in the first field enter http://localhost:8888/moodle28/, in the second field http://192.168.0.200:8888/moodle28/ (or the ip address that you have assigned in your installation). Use the correct spelling in both fields! With the hook you acknowledge that you know about the risk ...

====Open the firewall====
The firewall in OS X 10.6, 10.7, 10.8, and 10.9 can be enabled and disabled the ''System Preferences > Security > Firewall''. If the firewall is disabled, although Moodle4Mac works without further settings in the network, but your computer is vulnerable to all requests from the outside ... the latter you should not do!

[[Image:Moodle4Mac_Firewall1.png|520px]]

The the system firewall of OS X is a packet filter that determines for each program if a data packet should be passed or blocked. If the firewall is enabled every program must be entered on a list to respond to requests from outside. Moodle4Mac (or MAMP) uses the httpd program to deliver the sites. You will find httpd in the MAMP folder ... the path is ''/Application/MAMP/Library/bin/httpd''. To enter httpd into the whitelist of the firewall you must click forward on this path ... no idea if there would be a configuration file which you can edit.

You need to get this setting for the firewall only once. If httpd is approved then all computers in your local network can access to Moodle ... by the way it is not important which is used by httpd ... port 8888 or port 80.

Do not open the firewall for mysqld because Moodle itself gets a connection to mysql on the server but no user should communicate with mysql directly from the client.

[[Image:Moodle4Mac_Firewall2.png|520px]]

====Connect Moodle from your local network====
Your web server can be connected with the url http://192.168.0.200:8888/moodle28/ in your local network, where 192.168.0.200 is an example address which your Mac got from the local router. Usually such local numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x and you will be able to do your settings even if they differ from this description.

When you got all settings right then all users from any computer in your network will see your Moodle via http://192.168.0.200:8888/moodle28/. And there will be no problem with any operating system.

[[Image:Moodle4Mac_7.png|900px]]

====Connect Moodle from your local network with mobile devices====
The following images show the locale Moodle site with an iPad and an iPhone.

[[image:Moodle4Mac_8.png|890px]]

[[image:Moodle4Mac_9.png|490px]]

==Some words about the security ...==
====MAMP is not secure!====
MAMP can be used for testing and developing web sites locally on a Mac computer. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. MAMP is prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments. Be careful!

====How to secure MAMP?====
Moodle4Mac is a preconfigured package where all the default settings are accessible. The password for the Moodle admin user is known and must necessarily be changed.

But please do not think that this should be enough! Your Moodle could also be attacked through the back door via the database. You definitely need to change the passwords of the database users root and moodle, because these passwords are known. Otherwise any hacker could change the password of the user account admin to get full access to all the information in Moodle. Alternatively, the hacker could also assign another user account to full admin access and he would be able to read all informations ... the main admin would probably not notice of such a change. It is also possible to delete the database completely if you know the root access to the database so that all information could be lost in this case.

====Secure connections with HTTPS====
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==
It is very simple to update your locally installed Moodle. You start the update with a double click and everything happens automatically. All courses rest in Moodle. You do not need to renew your local Moodle completely ... you only get the new Moodle files.

====Update the local Moodle via Git====
Make sure that the Git program is installed on your Mac (see instructions below). You also need an Internet connection because the files are downloaded from the Moodle update server. A double click on the icon UpdateMoodle.sh starts the script and updating occurs automatically. That's really all ... could it be easier?

[[Image:Moodle4Mac_Update1.png]]

The Git program connects to the Moodle server and controls which files are new, which have changed and which have been deleted. The transmission time depends on the internet connection. With Git only really necessary files will be transmitted. If the transfer takes too long, you can abort the process with <ctrl>-c. You can easily start the update again later.

[[Image:Moodle4Mac_Update2.png|550px]]

  

====Script control ... looking inside ... ====

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor, e.g. TextWrangler.

It is only a text file but it uses a OS X feature to open and execute the script with the Terminal program. You don't need to learn anything ... doubleclick to update everything.

<pre>
#! /bin/sh
#
# This GIT installer for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20150511 - Ralf Krause
#

echo
echo "+--------------------------------------------+"
echo "| GIT updater for your local Moodle server"
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs

if ! test -e moodle28/.git ; then
## the first git update must get everything including .git
git clone --depth 1 -b MOODLE_28_STABLE git://github.com/moodle/moodle.git moodle28-git
if test -e moodle28-git ; then
if test -e moodle28 ; then
if test -e moodle28/config.php ; then
cp moodle28/config.php moodle28-git/.
fi
DATE=`date +%Y%m%d-%H%M`
mv moodle28 moodle28-$DATE
fi
mv moodle28-git moodle28
fi
## the old folder can be deleted now
## if you want to do this please remove '##' from the following line
## sudo rm -R moodle28-*
else
## the next git update only gets the new files
cd moodle28
git pull
cd ..
fi
</pre>

The different versions of the script UpdateMoodle.sh only differ in two parameters ... first we need to know the right folder for Moodle and second we must use the correct git tag for the Moodle version. The shown script upgrades Moodle 2.8.
* Moodle 2.0 uses MOODLE_20_STABLE
* Moodle 2.1 uses MOODLE_21_STABLE
* Moodle 2.2 uses MOODLE_22_STABLE
* Moodle 2.3 uses MOODLE_23_STABLE
* Moodle 2.4 uses MOODLE_24_STABLE
* Moodle 2.5 uses MOODLE_25_STABLE
* Moodle 2.6 uses MOODLE_26_STABLE
* Moodle 2.7 uses MOODLE_27_STABLE
* Moodle 2.8 uses MOODLE_28_STABLE
* Moodle 2.9 uses MOODLE_29_STABLE
* Moodle 3.0dev uses master

====Install Git====

Download the Git program from http://git-scm.com/download/ ... it's free and open source.

[[Image:Moodle4Mac_Git1.png]]
  

Open the disk image and doubleclick the installer git-xxx-osx.pkg. If you want to know more about Git then read the Git documentation on their web site ... but if you only want to update Moodle the script '''UpdateMoodle.sh''' should also work without reading

[[Image:Moodle4Mac_Git2.png|500px]]
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [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]

[[Category:Mac OS X]]

[[de:Installationspaket für OS X]]
[[es:Paquetes de Instalación Completos para Mac OS X]]

Installation Package for OS X

2015-04-06T12:08:14Z

Krause: /* System requirements */

{{Installing Moodle}}
==Summary==
The complete install packages for Mac OS X are named Moodle4Mac and allow a very easy way to install Moodle on your Mac computer (laptop, desktop, server). Moodle4Mac is available from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X]. You will find other downloads for Linux and Window Operating Systems that may involve more customization of configuration files.

Moodle4Mac is based on the software MAMP. MAMP contains everything that is necessary for the operation of Moodle, the Apache web server, MySQL database and PHP scripting language. For the various Moodle versions you can get different installation packages. Please check which Moodle your institution (school, college, university, company) uses on its server so that you can swap your materials between the two platforms easily.

Of course, you can install the latest Moodle development version to find everything about upcoming opportunities and changes. However, please remember that a developer version is not yet a finished product, and that a development version may contain errors.

Moodle4Mac is not intended to be used as a productive server on the Internet. It is only intended for installation on a local computer to test and develop. The configuration is not optimized for security. If you want to run Moodle on an OS X server connected to the internet, please read the instructions [https://docs.moodle.org/en/Step_by_Step_Installation_on_a_Mac_OS_X_Server Step by step installation on a OS X Server].

==System requirements==
+ Apple OS X Computer
+ iMac, Mac mini, MacBook, MacBook Air, Mac Pro
+ Processor: Intel x86_64 (i5, i7, Xeon, Core2Duo)
+ RAM: 4 GB or better
+ Hard Disk: 1 GB free
+ System Software: OS X 10.6, 10.7, 10.8, 10.9, 10.10

==Download and install ==
'''Step 1:''' Download the disk image '''Moodle4Mac-MAMP.dmg''' from the web site [http://download.moodle.org/macosx/ Moodle packages for Mac OS X] . You will find various image files for the different Moodle versions on this web site.

'''Step 2:''' Double click the disk image '''Moodle4Mac-MAMP.dmg''' to mount the installation disk.

[[Image:Moodle4Mac_1.png|500px]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac OS X, Apache, MySQL, PHP). MAMP does not save parameters in a registry or in system variables. If you want to delete Moodle4Mac you only need to move the MAMP folder into the Trash. For more information about MAMP please look at the [http://mamp.info/ MAMP project page].

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

[[Image:Moodle4Mac_2.png|500px]]

'''Step 5:''' Double click the MAMP icon to start the server.

[[Image:Moodle4Mac_3.png|500px]]

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

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

[[Image:Moodle4Mac_4.png|900px]]

==Language packages==

By default Moodle4Mac is delivered in English, any other language must be loaded. The german standard package ''de'' translates all text strings to german, the additional package ''de_du'' adds the informal conversation ''du'', the additional package ''de_kids'' provides scholastic simplifications.

The direct link for the language import is http://localhost:8888/moodle28/admin/tool/langimport/

[[Image:Moodle4Mac_5.png|900px]]

After importing the additional language pack, the settings for the default language for the user account '''admin''' can be switched to German. Only it you change the setting you will find the german menus and german settings dialogs your Moodle. Of course, all text in the text boxes on the home page and in the two preloaded courses Moodle4Mac About and How to update as they were originally entered ... if you like, you can change these texts like ....

==Completely backup your server==
Just as you installed Moodle4Mac the first time on your computer, you can backup a customized system completely. Because all files and configurations are stored within the directory MAMP, you can easily backup your MAMP directory to an external disk. Your Moodle will be frozen together with all settings and all the courses, and it can be recovered at any time in the same form.

First stop all server processes like httpd and mysqld, then exit the MAMP program. After everything stopped you can copy or move the MAMP directory. If you want to transfer MAMP to one or more other computers, you will create a ZIP archive containing the MAMP directory. This ZIP archive can be copied anywhere ... to an USB memory, to a web server, on a burned CD ...

The target computer must be a Mac. On this Mac, unpack the ZIP archive and move the MAMP folder to the Application folder ... done! Everything is going exactly as in section download and installation. In this way you can prepare your Moodle for a presentation or a training lab, and you can distribute it.

[[Image:Moodle4Mac_ZIP.png|500px]]

==Server in your local network==

In various workshops we used Moodle4Mac as a quick server installation for our local network. Make sure that you change the passwords for Moodle and MySQL before you allow access to this server ... otherwise, you'll be amazed how creative your user group can be. Please read the safety instructions of Moodle4Mac.

In this section you will see all required settings to use the server in the local network. Only three steps are required. The first step is to change one line in the config.php for Moodle. In the second step you need to adjust the base address in Moodle. And in your third step you open the firewall for ''httpd''.

To get your Moodle to another computer in your local network your Mac must be clearly addressable. You may use a fixed IP address or a DNS name. In local networks usually ip addresses of the private sections 10.xxx , 172.xxx , or 192.168.xx are assigned. If your Moodle4Mac gets an ip address this address must never change. Please do not use any static ip address if you do not know exactly what you do ... in case of doubt ask the administrator of the local network.

You can't use Moodle4Mac as a local server which is intended to work on different networks.

====Edit config.php====
For the following your computer should be a Mac in a computer lab. For this example it has the the fixed ip address 192.168.0.200. You must edit now the configuration ''/Applications/MAMP/htdocs/moodle24/config.php'' and change the wwwroot from ''localhost'' to ''192.168.0.200''. You must use your own address for your own network!!

After your changes you should get your Moodle with the address http://192.168.0.200/moodle24/

<pre><?php /// Moodle configuration file

unset($CFG);
global $CFG;
$CFG = new stdClass();

$CFG->dbtype = 'mysqli';
$CFG->dblibrary = 'native';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle28';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->prefix = 'mdl_';
$CFG->dboptions = array (
'dbpersit' => 0,
'dbport' => '',
'dbsocket' => 1,
);

// localhost wird auf 192.168.0.200 geändert
// $CFG->wwwroot = 'http://localhost:8888/moodle28';
$CFG->wwwroot = 'http://192.168.0.200:8888/moodle28';
$CFG->dataroot = '/Applications/MAMP/data/moodle28';
$CFG->admin = 'admin';

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

require_once(dirname(__FILE__) . '/lib/setup.php');

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

====Replace internal links in Moodle====
The original base address ''localhost'' is stored in many places within the database, your Moodle will not work properly with the modified base address. But images can not be displayed because they are accessible only from their correct address. From your local computer you might not see the problems but if you are outside on a computer getting access to the site.

Moodle has a tool that allows you to replace the database entries from http://localhost:8888/moodle24/ to http://192.168.0.200:8888/moodle28/ .

[[Image:Moodle4Mac_6.png|900px]]

You call this tool via the address http://192.168.0.200:8888/moodle28/admin/tool/replace/

No ... there is no menu option for it, probably because at thoughtless action with this tool also can shred the database ... in the first field enter http://localhost:8888/moodle28/, in the second field http://192.168.0.200:8888/moodle28/ (or the ip address that you have assigned in your installation). Use the correct spelling in both fields! With the hook you acknowledge that you know about the risk ...

====Open the firewall====
The firewall in OS X 10.6, 10.7, 10.8, and 10.9 can be enabled and disabled the ''System Preferences > Security > Firewall''. If the firewall is disabled, although Moodle4Mac works without further settings in the network, but your computer is vulnerable to all requests from the outside ... the latter you should not do!

[[Image:Moodle4Mac_Firewall1.png|520px]]

The the system firewall of OS X is a packet filter that determines for each program if a data packet should be passed or blocked. If the firewall is enabled every program must be entered on a list to respond to requests from outside. Moodle4Mac (or MAMP) uses the httpd program to deliver the sites. You will find httpd in the MAMP folder ... the path is ''/Application/MAMP/Library/bin/httpd''. To enter httpd into the whitelist of the firewall you must click forward on this path ... no idea if there would be a configuration file which you can edit.

You need to get this setting for the firewall only once. If httpd is approved then all computers in your local network can access to Moodle ... by the way it is not important which is used by httpd ... port 8888 or port 80.

Do not open the firewall for mysqld because Moodle itself gets a connection to mysql on the server but no user should communicate with mysql directly from the client.

[[Image:Moodle4Mac_Firewall2.png|520px]]

====Connect Moodle from your local network====
Your web server can be connected with the url http://192.168.0.200:8888/moodle28/ in your local network, where 192.168.0.200 is an example address which your Mac got from the local router. Usually such local numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x and you will be able to do your settings even if they differ from this description.

When you got all settings right then all users from any computer in your network will see your Moodle via http://192.168.0.200:8888/moodle28/. And there will be no problem with any operating system.

[[Image:Moodle4Mac_7.png|900px]]

====Connect Moodle from your local network with mobile devices====
The following images show the locale Moodle site with an iPad and an iPhone.

[[image:Moodle4Mac_8.png|890px]]

[[image:Moodle4Mac_9.png|490px]]

==Some words about the security ...==
====MAMP is not secure!====
MAMP can be used for testing and developing web sites locally on a Mac computer. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. MAMP is prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments. Be careful!

====How to secure MAMP?====
Moodle4Mac is a preconfigured package where all the default settings are accessible. The password for the Moodle admin user is known and must necessarily be changed.

But please do not think that this should be enough! Your Moodle could also be attacked through the back door via the database. You definitely need to change the passwords of the database users root and moodle, because these passwords are known. Otherwise any hacker could change the password of the user account admin to get full access to all the information in Moodle. Alternatively, the hacker could also assign another user account to full admin access and he would be able to read all informations ... the main admin would probably not notice of such a change. It is also possible to delete the database completely if you know the root access to the database so that all information could be lost in this case.

====Secure connections with HTTPS====
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==
It is very simple to update your locally installed Moodle. You start the update with a double click and everything happens automatically. All courses rest in Moodle. You do not need to renew your local Moodle completely ... you only get the new Moodle files.

====Update the local Moodle via Git====
Make sure that the Git program is installed on your Mac (see instructions below). You also need an Internet connection because the files are downloaded from the Moodle update server. A double click on the icon UpdateMoodle.sh starts the script and updating occurs automatically. That's really all ... could it be easier?

[[Image:Moodle4Mac_Update1.png]]

The Git program connects to the Moodle server and controls which files are new, which have changed and which have been deleted. The transmission time depends on the internet connection. With Git only really necessary files will be transmitted. If the transfer takes too long, you can abort the process with <ctrl>-c. You can easily start the update again later.

[[Image:Moodle4Mac_Update2.png|550px]]

  

====Script control ... looking inside ... ====

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor, e.g. TextWrangler.

It is only a text file but it uses a OS X feature to open and execute the script with the Terminal program. You don't need to learn anything ... doubleclick to update everything.

<pre>
#! /bin/sh
#
# This GIT installer for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20141110 - Ralf Krause
#

echo
echo "+--------------------------------------------+"
echo "| GIT updater for your local Moodle server"
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs

if ! test -e moodle28/.git ; then
## the first git update must get everything including .git
git clone --depth 1 -b MOODLE_28_STABLE git://github.com/moodle/moodle.git moodle28-git
if test -e moodle28 ; then
if test -e moodle28 ; then
if test -e moodle28/config.php ; then
cp moodle28/config.php moodle28-git/.
fi
DATE=`date +%Y%m%d-%H%M`
mv moodle28 moodle28-$DATE
fi
mv moodle28-git moodle28
fi
## the old folder can be deleted now
## if you want to do this please remove '##' from the following line
## sudo rm -R moodle28-*
else
## the next git update only gets the new files
cd moodle28
git pull
cd ..
fi
</pre>

The different versions of the script UpdateMoodle.sh only differ in two parameters ... first we need to know the right folder for Moodle and second we must use the correct git tag for the Moodle version. The shown script upgrades Moodle 2.8.
* Moodle 2.0 uses MOODLE_20_STABLE
* Moodle 2.1 uses MOODLE_21_STABLE
* Moodle 2.2 uses MOODLE_22_STABLE
* Moodle 2.3 uses MOODLE_23_STABLE
* Moodle 2.4 uses MOODLE_24_STABLE
* Moodle 2.5 uses MOODLE_25_STABLE
* Moodle 2.6 uses MOODLE_26_STABLE
* Moodle 2.7 uses MOODLE_27_STABLE
* Moodle 2.8 uses MOODLE_28_STABLE
* Moodle 2.9dev uses master

====Install Git====

Download the Git program from http://git-scm.com/download/ ... it's free and open source.

[[Image:Moodle4Mac_Git1.png]]
  

Open the disk image and doubleclick the installer git-xxx-osx.pkg. If you want to know more about Git then read the Git documentation on their web site ... but if you only want to update Moodle the script '''UpdateMoodle.sh''' should also work without reading

[[Image:Moodle4Mac_Git2.png|500px]]
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [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]

[[Category:Mac OS X]]

[[de:Installationspaket für OS X]]
[[es:Paquetes de Instalación Completos para Mac OS X]]

Installation Package for OS X

2014-11-21T10:12:16Z

Krause: /* Script control ... looking inside ... */

{{Installing Moodle}}
==Summary==
The complete install packages for Mac OS X are named Moodle4Mac and allow a very easy way to install Moodle on your Mac computer (laptop, desktop, server). Moodle4Mac is available from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X]. You will find other downloads for Linux and Window Operating Systems that may involve more customization of configuration files.

Moodle4Mac is based on the software MAMP. MAMP contains everything that is necessary for the operation of Moodle, the Apache web server, MySQL database and PHP scripting language. For the various Moodle versions you can get different installation packages. Please check which Moodle your institution (school, college, university, company) uses on its server so that you can swap your materials between the two platforms easily.

Of course, you can install the latest Moodle development version to find everything about upcoming opportunities and changes. However, please remember that a developer version is not yet a finished product, and that a development version may contain errors.

Moodle4Mac is not intended to be used as a productive server on the Internet. It is only intended for installation on a local computer to test and develop. The configuration is not optimized for security. If you want to run Moodle on an OS X server connected to the internet, please read the instructions [https://docs.moodle.org/en/Step_by_Step_Installation_on_a_Mac_OS_X_Server Step by step installation on a OS X Server].

==System requirements==
+ Apple OS X Computer
+ iMac, Mac mini, MacBook, MacBook Air, Mac Pro
+ Processor: Intel x86_64 (i5, i7, Xeon, Core2Duo)
+ RAM: 4 GB or better
+ Hard Disk: 1 GB free
+ System Software: OS X 10.6, 10.7, 10.8, 10.9

==Download and install ==
'''Step 1:''' Download the disk image '''Moodle4Mac-MAMP.dmg''' from the web site [http://download.moodle.org/macosx/ Moodle packages for Mac OS X] . You will find various image files for the different Moodle versions on this web site.

'''Step 2:''' Double click the disk image '''Moodle4Mac-MAMP.dmg''' to mount the installation disk.

[[Image:Moodle4Mac_1.png|500px]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac OS X, Apache, MySQL, PHP). MAMP does not save parameters in a registry or in system variables. If you want to delete Moodle4Mac you only need to move the MAMP folder into the Trash. For more information about MAMP please look at the [http://mamp.info/ MAMP project page].

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

[[Image:Moodle4Mac_2.png|500px]]

'''Step 5:''' Double click the MAMP icon to start the server.

[[Image:Moodle4Mac_3.png|500px]]

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

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

[[Image:Moodle4Mac_4.png|900px]]

==Language packages==

By default Moodle4Mac is delivered in English, any other language must be loaded. The german standard package ''de'' translates all text strings to german, the additional package ''de_du'' adds the informal conversation ''du'', the additional package ''de_kids'' provides scholastic simplifications.

The direct link for the language import is http://localhost:8888/moodle28/admin/tool/langimport/

[[Image:Moodle4Mac_5.png|900px]]

After importing the additional language pack, the settings for the default language for the user account '''admin''' can be switched to German. Only it you change the setting you will find the german menus and german settings dialogs your Moodle. Of course, all text in the text boxes on the home page and in the two preloaded courses Moodle4Mac About and How to update as they were originally entered ... if you like, you can change these texts like ....

==Completely backup your server==
Just as you installed Moodle4Mac the first time on your computer, you can backup a customized system completely. Because all files and configurations are stored within the directory MAMP, you can easily backup your MAMP directory to an external disk. Your Moodle will be frozen together with all settings and all the courses, and it can be recovered at any time in the same form.

First stop all server processes like httpd and mysqld, then exit the MAMP program. After everything stopped you can copy or move the MAMP directory. If you want to transfer MAMP to one or more other computers, you will create a ZIP archive containing the MAMP directory. This ZIP archive can be copied anywhere ... to an USB memory, to a web server, on a burned CD ...

The target computer must be a Mac. On this Mac, unpack the ZIP archive and move the MAMP folder to the Application folder ... done! Everything is going exactly as in section download and installation. In this way you can prepare your Moodle for a presentation or a training lab, and you can distribute it.

[[Image:Moodle4Mac_ZIP.png|500px]]

==Server in your local network==

In various workshops we used Moodle4Mac as a quick server installation for our local network. Make sure that you change the passwords for Moodle and MySQL before you allow access to this server ... otherwise, you'll be amazed how creative your user group can be. Please read the safety instructions of Moodle4Mac.

In this section you will see all required settings to use the server in the local network. Only three steps are required. The first step is to change one line in the config.php for Moodle. In the second step you need to adjust the base address in Moodle. And in your third step you open the firewall for ''httpd''.

To get your Moodle to another computer in your local network your Mac must be clearly addressable. You may use a fixed IP address or a DNS name. In local networks usually ip addresses of the private sections 10.xxx , 172.xxx , or 192.168.xx are assigned. If your Moodle4Mac gets an ip address this address must never change. Please do not use any static ip address if you do not know exactly what you do ... in case of doubt ask the administrator of the local network.

You can't use Moodle4Mac as a local server which is intended to work on different networks.

====Edit config.php====
For the following your computer should be a Mac in a computer lab. For this example it has the the fixed ip address 192.168.0.200. You must edit now the configuration ''/Applications/MAMP/htdocs/moodle24/config.php'' and change the wwwroot from ''localhost'' to ''192.168.0.200''. You must use your own address for your own network!!

After your changes you should get your Moodle with the address http://192.168.0.200/moodle24/

<pre><?php /// Moodle configuration file

unset($CFG);
global $CFG;
$CFG = new stdClass();

$CFG->dbtype = 'mysqli';
$CFG->dblibrary = 'native';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle28';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->prefix = 'mdl_';
$CFG->dboptions = array (
'dbpersit' => 0,
'dbport' => '',
'dbsocket' => 1,
);

// localhost wird auf 192.168.0.200 geändert
// $CFG->wwwroot = 'http://localhost:8888/moodle28';
$CFG->wwwroot = 'http://192.168.0.200:8888/moodle28';
$CFG->dataroot = '/Applications/MAMP/data/moodle28';
$CFG->admin = 'admin';

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

require_once(dirname(__FILE__) . '/lib/setup.php');

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

====Replace internal links in Moodle====
The original base address ''localhost'' is stored in many places within the database, your Moodle will not work properly with the modified base address. But images can not be displayed because they are accessible only from their correct address. From your local computer you might not see the problems but if you are outside on a computer getting access to the site.

Moodle has a tool that allows you to replace the database entries from http://localhost:8888/moodle24/ to http://192.168.0.200:8888/moodle28/ .

[[Image:Moodle4Mac_6.png|900px]]

You call this tool via the address http://192.168.0.200:8888/moodle28/admin/tool/replace/

No ... there is no menu option for it, probably because at thoughtless action with this tool also can shred the database ... in the first field enter http://localhost:8888/moodle28/, in the second field http://192.168.0.200:8888/moodle28/ (or the ip address that you have assigned in your installation). Use the correct spelling in both fields! With the hook you acknowledge that you know about the risk ...

====Open the firewall====
The firewall in OS X 10.6, 10.7, 10.8, and 10.9 can be enabled and disabled the ''System Preferences > Security > Firewall''. If the firewall is disabled, although Moodle4Mac works without further settings in the network, but your computer is vulnerable to all requests from the outside ... the latter you should not do!

[[Image:Moodle4Mac_Firewall1.png|520px]]

The the system firewall of OS X is a packet filter that determines for each program if a data packet should be passed or blocked. If the firewall is enabled every program must be entered on a list to respond to requests from outside. Moodle4Mac (or MAMP) uses the httpd program to deliver the sites. You will find httpd in the MAMP folder ... the path is ''/Application/MAMP/Library/bin/httpd''. To enter httpd into the whitelist of the firewall you must click forward on this path ... no idea if there would be a configuration file which you can edit.

You need to get this setting for the firewall only once. If httpd is approved then all computers in your local network can access to Moodle ... by the way it is not important which is used by httpd ... port 8888 or port 80.

Do not open the firewall for mysqld because Moodle itself gets a connection to mysql on the server but no user should communicate with mysql directly from the client.

[[Image:Moodle4Mac_Firewall2.png|520px]]

====Connect Moodle from your local network====
Your web server can be connected with the url http://192.168.0.200:8888/moodle28/ in your local network, where 192.168.0.200 is an example address which your Mac got from the local router. Usually such local numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x and you will be able to do your settings even if they differ from this description.

When you got all settings right then all users from any computer in your network will see your Moodle via http://192.168.0.200:8888/moodle28/. And there will be no problem with any operating system.

[[Image:Moodle4Mac_7.png|900px]]

====Connect Moodle from your local network with mobile devices====
The following images show the locale Moodle site with an iPad and an iPhone.

[[image:Moodle4Mac_8.png|890px]]

[[image:Moodle4Mac_9.png|490px]]

==Some words about the security ...==
====MAMP is not secure!====
MAMP can be used for testing and developing web sites locally on a Mac computer. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. MAMP is prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments. Be careful!

====How to secure MAMP?====
Moodle4Mac is a preconfigured package where all the default settings are accessible. The password for the Moodle admin user is known and must necessarily be changed.

But please do not think that this should be enough! Your Moodle could also be attacked through the back door via the database. You definitely need to change the passwords of the database users root and moodle, because these passwords are known. Otherwise any hacker could change the password of the user account admin to get full access to all the information in Moodle. Alternatively, the hacker could also assign another user account to full admin access and he would be able to read all informations ... the main admin would probably not notice of such a change. It is also possible to delete the database completely if you know the root access to the database so that all information could be lost in this case.

====Secure connections with HTTPS====
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==
It is very simple to update your locally installed Moodle. You start the update with a double click and everything happens automatically. All courses rest in Moodle. You do not need to renew your local Moodle completely ... you only get the new Moodle files.

====Update the local Moodle via Git====
Make sure that the Git program is installed on your Mac (see instructions below). You also need an Internet connection because the files are downloaded from the Moodle update server. A double click on the icon UpdateMoodle.sh starts the script and updating occurs automatically. That's really all ... could it be easier?

[[Image:Moodle4Mac_Update1.png]]

The Git program connects to the Moodle server and controls which files are new, which have changed and which have been deleted. The transmission time depends on the internet connection. With Git only really necessary files will be transmitted. If the transfer takes too long, you can abort the process with <ctrl>-c. You can easily start the update again later.

[[Image:Moodle4Mac_Update2.png|550px]]

  

====Script control ... looking inside ... ====

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor, e.g. TextWrangler.

It is only a text file but it uses a OS X feature to open and execute the script with the Terminal program. You don't need to learn anything ... doubleclick to update everything.

<pre>
#! /bin/sh
#
# This GIT installer for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20141110 - Ralf Krause
#

echo
echo "+--------------------------------------------+"
echo "| GIT updater for your local Moodle server"
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs

if ! test -e moodle28/.git ; then
## the first git update must get everything including .git
git clone --depth 1 -b MOODLE_28_STABLE git://github.com/moodle/moodle.git moodle28-git
if test -e moodle28 ; then
if test -e moodle28 ; then
if test -e moodle28/config.php ; then
cp moodle28/config.php moodle28-git/.
fi
DATE=`date +%Y%m%d-%H%M`
mv moodle28 moodle28-$DATE
fi
mv moodle28-git moodle28
fi
## the old folder can be deleted now
## if you want to do this please remove '##' from the following line
## sudo rm -R moodle28-*
else
## the next git update only gets the new files
cd moodle28
git pull
cd ..
fi
</pre>

The different versions of the script UpdateMoodle.sh only differ in two parameters ... first we need to know the right folder for Moodle and second we must use the correct git tag for the Moodle version. The shown script upgrades Moodle 2.8.
* Moodle 2.0 uses MOODLE_20_STABLE
* Moodle 2.1 uses MOODLE_21_STABLE
* Moodle 2.2 uses MOODLE_22_STABLE
* Moodle 2.3 uses MOODLE_23_STABLE
* Moodle 2.4 uses MOODLE_24_STABLE
* Moodle 2.5 uses MOODLE_25_STABLE
* Moodle 2.6 uses MOODLE_26_STABLE
* Moodle 2.7 uses MOODLE_27_STABLE
* Moodle 2.8 uses MOODLE_28_STABLE
* Moodle 2.9dev uses master

====Install Git====

Download the Git program from http://git-scm.com/download/ ... it's free and open source.

[[Image:Moodle4Mac_Git1.png]]
  

Open the disk image and doubleclick the installer git-xxx-osx.pkg. If you want to know more about Git then read the Git documentation on their web site ... but if you only want to update Moodle the script '''UpdateMoodle.sh''' should also work without reading

[[Image:Moodle4Mac_Git2.png|500px]]
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [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]

[[Category:Mac OS X]]

[[de:Installationspaket für OS X]]
[[es:Paquetes de Instalación Completos para Mac OS X]]

Moodle app additional features

2014-08-04T16:11:47Z

Krause:

{{Infobox plugin
|type = Local plugin
|entry = http://moodle.org/plugins/view.php?plugin=local_mobile
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/13930
|discussion = http://moodle.org/mod/forum/view.php?id=
|maintainer = [[User:Juan Leyva|Juan Leyva]]
}}

Local plugin for adding new features to the current Moodle Mobile app ([https://moodle.org/plugins/view.php?plugin=local_mobile Plugin download link])

This add-on provides new features and web services which are currently only available in the latest Moodle version.

== How it works ==

Once installed the plugin creates a new service "Moodle Mobile additional features".

The Mobile app checks if this service is enabled. If not, the Mobile app falls backs to the standard core Mobile app service.

== Features ==

* Support for sites using SSO authentication methods (Shibboleth and CAS)
* Push notifications
* Retrieval of private messages and notifications from the site
* Retrieval of calendar events from the site

=== Enable authentication for sites using SSO methods (like Shibboleth and CAS) ===

Once the plugin is installed, you need to go to Site administration > Plugins > Local plugins > Moodle Mobile additional features

There you can choose the "Type of login":

- Via the app: Is the default login, the user must introduce his credentials in the app

- Via a browser window: A new browser instance is open in the mobile device pointing to the login form in the Moodle site. The user must introduce his credentials there. This is the option that must be selected for sites using SSO methods (or for sites that wants to force the user to authenticate in the site, not in the app)

<mediaplayer>https://www.youtube.com/watch?v=cl8rsyyyg9g</mediaplayer>

=== Push notifications ===

If you want to enable Push notifications in Moodle sites prior to version 2.6 this plugin must be installed.

See [[Mobile app Push Notifications]] for more information

== Installation ==

1. Unpack the zip file into the local/ directory. A new directory will be created called local/mobile.

2. Go to Site administration > Notifications to complete the plugin installation.

3. Go to Site administration > Plugins > Web services > External services, edit "Moodle Mobile additional features" and check the "Enabled" field, then save changes.

4. Go to Site administration > Users > Define roles, edit the Authenticated user role and allow the capability moodle/webservice:createtoken.

Note: You need to have upgraded the Moodle Mobile app to version 1.4.4.

If you are currently using the Moodle Mobile app, you will need to log out of all your sites in order for the app to detect the new service.

== Admin users, please read ==

This plugin installs a new service in your Moodle installation, the automatic token creation for this type of services is forbidden for admin users. This means that admin users will not be able to use the Mobile app.

This can be solved easily, administrators must create a token manually in Moodle (Plugins > Web Services > Manage tokens) for the local_mobile service.

== See also ==

[https://moodle.org/plugins/view.php?plugin=local_mobile Plugin entry in the plugins database]

[[Category: Mobile]]

[[de:Mobile App - Zusatzfeatures]]
[[es:Características adicionales de Moodle Mobile]]

Moodle app additional features

2014-07-21T15:09:47Z

Krause:

{{Infobox plugin
|type = Local plugin
|entry = http://moodle.org/plugins/view.php?plugin=local_mobile
|tracker = https://tracker.moodle.org/browse/CONTRIB/component/13930
|discussion = http://moodle.org/mod/forum/view.php?id=
|maintainer = [[User:Juan Leyva|Juan Leyva]]
}}

Local plugin for adding new features to the current Moodle Mobile app ([https://moodle.org/plugins/view.php?plugin=local_mobile Plugin download link])

This add-on provides new features and web services which are currently only available in Moodle 2.7.

== How it works ==

Once installed the plugin creates a new service "Moodle Mobile additional features".

The Mobile app checks if this service is enabled. If not, the Mobile app falls backs to the standard core Mobile app service.

== Features ==

* Support for sites using SSO authentication methods (Shibboleth and CAS)
* Push notifications
* Retrieval of private messages and notifications from the site
* Retrieval of calendar events from the site

=== Enable authentication for sites using SSO methods (like Shibboleth and CAS) ===

Once the plugin is installed, you need to go to Site administration > Plugins > Local plugins > Moodle Mobile additional features

There you can choose the "Type of login":

- Via the app: Is the default login, the user must introduce his credentials in the app

- Via a browser window: A new browser instance is open in the mobile device pointing to the login form in the Moodle site. The user must introduce his credentials there. This is the option that must be selected for sites using SSO methods (or for sites that wants to force the user to authenticate in the site, not in the app)

<mediaplayer>https://www.youtube.com/watch?v=cl8rsyyyg9g</mediaplayer>

=== Push notifications ===

If you want to enable Push notifications in Moodle sites prior to version 2.6 this plugin must be installed.

See [[Mobile app Push Notifications]] for more information

== Installation ==

1. Unpack the zip file into the local/ directory. A new directory will be created called local/mobile.

2. Go to Site administration > Notifications to complete the plugin installation.

3. Go to Site administration > Plugins > Web services > External services, edit "Moodle Mobile additional features" and check the "Enabled" field, then save changes.

4. Go to Site administration > Users > Define roles, edit the Authenticated user role and allow the capability moodle/webservice:createtoken.

Note: You need to have upgraded the Moodle Mobile app to version 1.4.4.

If you are currently using the Moodle Mobile app, you will need to log out of all your sites in order for the app to detect the new service.

== Admin users, please read ==

This plugin installs a new service in your Moodle installation, the automatic token creation for this type of services is forbidden for admin users. This means that admin users will not be able to use the Mobile app.

This can be solved easily, administrators must create a token manually in Moodle (Plugins > Web Services > Manage tokens) for the local_mobile service.

== See also ==

[https://moodle.org/plugins/view.php?plugin=local_mobile Plugin entry in the plugins database]

[[Category: Mobile]]

[[de:Mobile App - Lokales Plugin]]

Moodle app FAQ

2014-07-21T15:06:50Z

Krause:

{{Mobile}}
== How can I use Moodle on mobile devices? ==
There are currently 3 main ways to use Moodle on mobile devices:

* Users can open Moodle sites in their mobile web browsers.
* Users can download native apps for their mobile devices.
* Admins can configure their Moodle site to be Mobile-accessible through server extensions.

=== Mobile Apps ===
* The official [[Mobile app]] developed by Juan Leyva with support from Jerome Mouneyrac, Moodle HQ and others.
* [http://www.moodletouch.com MoodleTouch] (aka ''mTouch'') for iOS, created by Ali OzGur
* [http://mpage.hk/ mPage] for iOS and Android (work in progress), created by Mass Media HK
* [http://codeguild.org/app/mbot/ Mbot] for Android, created by Code Guild
* The [https://docs.moodle.org/23/en/Mobile_app My Moodle app] for iPhone, created by Moodle HQ (no longer being developed)
* [https://market.android.com/details?id=com.ivoid.droodle Droodle] - an Android client for the Moodle 2.1 platform

=== Server-side ===
* [http://www.mobilemoodle.org/momo18/ MoMo] (Moodle for Mobiles) - Requires a server extension and a client app; supports most mobile OSes including Symbian.
* [http://code.google.com/p/moodbile/ Moodbile] - Reference implementation of Moodle Web Services. Under development.
* [http://iphone.moodle.com.au iPhone4Moodle] - Under development.

==Where can I download the official Mobile app for iPhone and Android?==

The app can be downloaded for free from the Google Play Store and Apple app store.

==How do I get the official Mobile app to work for my Moodle site?==

Firstly, your Moodle site must be using Moodle 2.4 or later.

Secondly mobile web services must be enabled. See [[Enable mobile web services]] for details.

==Where can I select a theme for mobile devices?==

In ''Site administration > Appearance > Themes > Theme selector''.

New in Moodle 2.2 onwards is the MyMobile theme especially designed for mobile devices.

== I can't access my Moodle site using the app ==

Notice that by default Mobile access is disabled in Moodle. The administrator of your Moodle site (which must be version 2.4 or later) must enable mobile access.

Also, authentication methods like Shibboleth, CAS or LDAP/SSO are not supported currently. See https://tracker.moodle.org/browse/MOBILE-113 for more information.

You should verify also that Debugging and "Display debug messages" are disabled in your site (go to Administration / Development / Debugging for checking that options)

== Moodle Mobile app says I need 2.4 or higher ==

The administrator of your Moodle site (which must be version 2.4 or later) must enable mobile access as follows:

In Site administration > Plugins > Web services > Mobile tick the 'Enable web services for mobile devices' checkbox, then click the button to save changes.

Some Moodle sites uses special authentication methods like Shibboleth, CAS or LDAP/SSO that currently are not supported. See https://tracker.moodle.org/browse/MOBILE-113 for more information.

==I can't view the courses tab as an administrator==
Moodle Mobile app is not suited for administrators ad the app displays only the courses you are enrolled in (not the courses you can see by capabilities).Note that the targeted user of the app is mainly a student or teacher.If you want to see the courses as an admin, you must be enrolled in the courses. You can use a non visible role or something similar.

== What happened with the remote translation feature? ==
Remote translation is not available anymore, this feature was deleted because due to core changes in Moodle it neter worked as expected

Language packs comes now with the app bundle, if you want to contribute translating the app you can use [http://lang.moodle.org AMOS tool] for translating, the component name is local_moodlemobileapp

More information here: https://moodle.org/mod/forum/discuss.php?d=252704

== I got the "we lost connection, you need to reconnect. Your token is now invalid." on my custom version of Moodle Mobile ==

Please, verify that you have followed all the steps here: https://docs.moodle.org/dev/Moodle_Mobile_Developing_a_plugin_tutorial#Set_up_your_Moodle_installation

And also that you have enabled the moodle/webservice:createtoken capability for the Authenticated User Role at System Context

==See also==

* [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum]
* Tracker area [http://tracker.moodle.org/browse/MOBILE Moodle for Mobiles]
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=162872 Proposal for Supporting Mobile Themes and Browser Detection] forum discussion
* An open course, about "[http://tempus-efa.proj.ac.il/moodle/course/view.php?id=102 Teaching using Mobile - Best practices]"
* [http://www.moodlenews.com/mobile/ Moodle News - Mobile] - a breakdown of the mobile projects and products available

[[Category:FAQ]]

[[de:Mobile Moodle FAQ]]
[[es:Moodle para móviles FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Moodle app FAQ

2014-07-21T15:05:12Z

Krause:

{{Mobile}}
== How can I use Moodle on mobile devices? ==
There are currently 3 main ways to use Moodle on mobile devices:

* Users can open Moodle sites in their mobile web browsers.
* Users can download native apps for their mobile devices.
* Admins can configure their Moodle site to be Mobile-accessible through server extensions.

=== Mobile Apps ===
* The official [[Mobile app]] developed by Juan Leyva with support from Jerome Mouneyrac, Moodle HQ and others.
* [http://www.moodletouch.com MoodleTouch] (aka ''mTouch'') for iOS, created by Ali OzGur
* [http://mpage.hk/ mPage] for iOS and Android (work in progress), created by Mass Media HK
* [http://codeguild.org/app/mbot/ Mbot] for Android, created by Code Guild
* The [https://docs.moodle.org/23/en/Mobile_app My Moodle app] for iPhone, created by Moodle HQ (no longer being developed)
* [https://market.android.com/details?id=com.ivoid.droodle Droodle] - an Android client for the Moodle 2.1 platform

=== Server-side ===
* [http://www.mobilemoodle.org/momo18/ MoMo] (Moodle for Mobiles) - Requires a server extension and a client app; supports most mobile OSes including Symbian.
* [http://code.google.com/p/moodbile/ Moodbile] - Reference implementation of Moodle Web Services. Under development.
* [http://iphone.moodle.com.au iPhone4Moodle] - Under development.

==Where can I download the official Mobile app for iPhone and Android?==

The app can be downloaded for free from the Google Play Store and Apple app store.

==How do I get the official Mobile app to work for my Moodle site?==

Firstly, your Moodle site must be using Moodle 2.4 or later.

Secondly mobile web services must be enabled. See [[Enable mobile web services]] for details.

==Where can I select a theme for mobile devices?==

In ''Site administration > Appearance > Themes > Theme selector''.

New in Moodle 2.2 onwards is the MyMobile theme especially designed for mobile devices.

== I can't access my Moodle site using the app ==

Notice that by default Mobile access is disabled in Moodle. The administrator of your Moodle site (which must be version 2.4 or later) must enable mobile access.

Also, authentication methods like Shibboleth, CAS or LDAP/SSO are not supported currently. See https://tracker.moodle.org/browse/MOBILE-113 for more information.

You should verify also that Debugging and "Display debug messages" are disabled in your site (go to Administration / Development / Debugging for checking that options)

== Moodle Mobile app says I need 2.4 or higher ==

The administrator of your Moodle site (which must be version 2.4 or later) must enable mobile access as follows:

In Site administration > Plugins > Web services > Mobile tick the 'Enable web services for mobile devices' checkbox, then click the button to save changes.

Some Moodle sites uses special authentication methods like Shibboleth, CAS or LDAP/SSO that currently are not supported. See https://tracker.moodle.org/browse/MOBILE-113 for more information.

==I can't view the courses tab as an administrator==
Moodle Mobile app is not suited for administrators ad the app displays only the courses you are enrolled in (not the courses you can see by capabilities).Note that the targeted user of the app is mainly a student or teacher.If you want to see the courses as an admin, you must be enrolled in the courses. You can use a non visible role or something similar.

== What happened with the remote translation feature? ==
Remote translation is not available anymore, this feature was deleted because due to core changes in Moodle it neter worked as expected

Language packs comes now with the app bundle, if you want to contribute translating the app you can use [http://lang.moodle.org AMOS tool] for translating, the component name is local_moodlemobileapp

More information here: https://moodle.org/mod/forum/discuss.php?d=252704

== I got the "we lost connection, you need to reconnect. Your token is now invalid." on my custom version of Moodle Mobile ==

Please, verify that you have followed all the steps here: https://docs.moodle.org/dev/Moodle_Mobile_Developing_a_plugin_tutorial#Set_up_your_Moodle_installation

And also that you have enabled the moodle/webservice:createtoken capability for the Authenticated User Role at System Context

==See also==

* [http://moodle.org/mod/forum/view.php?id=7798 Moodle for mobile forum]
* Tracker area [http://tracker.moodle.org/browse/MOBILE Moodle for Mobiles]
* Using Moodle [http://moodle.org/mod/forum/discuss.php?d=162872 Proposal for Supporting Mobile Themes and Browser Detection] forum discussion
* An open course, about "[http://tempus-efa.proj.ac.il/moodle/course/view.php?id=102 Teaching using Mobile - Best practices]"
* [http://www.moodlenews.com/mobile/ Moodle News - Mobile] - a breakdown of the mobile projects and products available

[[Category:FAQ]]

[[de:Mobile Moodle FAQ]]
[[fr:Moodle pour les mobiles]]
[[ja:モバイルMoodle FAQ]]

Mobile app Push Notifications

2014-07-21T14:50:05Z

Krause:

Starting versions (1.4 iOS, iPhone, iPad and 1.4.3 Android) Moodle Mobile support Push Notifications.

1. Install [https://moodle.org/plugins/view.php?plugin=message_airnotifier this plugin] in 2.4, 2.5 or 2.6* (or simply enable it in 2.7)

2. Connect it to a mesaging server, you can use ours in case your Moodle site is registered. Go to Site administration /Plugins /Message outputs /Mobile Notifications and click in Request access key

3. Users need to connect at least once with the latest version of the app to register their phones with your site.

4) Users can configure notificiations in the Moodle messaging preferences (Administration / My profile settings / Messaging)

* For Moodle versions 2.4 and 2.5 the [[Moodle Mobile additional features]] must be also installed
** Only for Moodle different to 2.7 and onwards: If you upgrade your Moodle installation, you will have to reinstall the plugin since it add a couple of functions to the core Moodle Mobile service. See https://tracker.moodle.org/browse/MDLSITE-2815?focusedCommentId=273741&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-273741 for more information

== Installing your own Notifications infrastructure ==

If you have a customized version of the Mobile app, or you want to use your own Notifications infrastructure then you have to install a private [http://airnotifier.github.io AirNotifier] (backend server for notifciations)

You have to add your app certificates there, see https://github.com/airnotifier/airnotifier/wiki/Installation

The message AirNotifier plugin allow you to point to your custom AirNotifier instance using your own access keys

Remember to install using GIT (branch moodle)

== See also ==

[[Category: Mobile]]

[[de:Mobile App - Push-Mitteilungen]]
[[es:Mobile app Notificaciones Push]]

Mobile app Push Notifications

2014-07-21T14:40:05Z

Krause:

Starting versions (1.4 iOS, iPhone, iPad and 1.4.3 Android) Moodle Mobile support Push Notifications.

1. Install [https://moodle.org/plugins/view.php?plugin=message_airnotifier this plugin] in 2.4, 2.5 or 2.6* (or simply enable it in 2.7)

2. Connect it to a mesaging server, you can use ours in case your Moodle site is registered. Go to Site administration /Plugins /Message outputs /Mobile Notifications and click in Request access key

3. Users need to connect at least once with the latest version of the app to register their phones with your site.

4) Users can configure notificiations in the Moodle messaging preferences (Administration / My profile settings / Messaging)

* For Moodle versions 2.4 and 2.5 the [[Moodle Mobile additional features]] must be also installed
** Only for Moodle different to 2.7 and onwards: If you upgrade your Moodle installation, you will have to reinstall the plugin since it add a couple of functions to the core Moodle Mobile service. See https://tracker.moodle.org/browse/MDLSITE-2815?focusedCommentId=273741&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-273741 for more information

== Installing your own Notifications infrastructure ==

If you have a customized version of the Mobile app, or you want to use your own Notifications infrastructure then you have to install a private [http://airnotifier.github.io AirNotifier] (backend server for notifciations)

You have to add your app certificates there, see https://github.com/airnotifier/airnotifier/wiki/Installation

The message AirNotifier plugin allow you to point to your custom AirNotifier instance using your own access keys

Remember to install using GIT (branch moodle)

== See also ==

[[Category: Mobile]]

[[de:Mobile App Push-Mitteilungen]]
[[es:Mobile app Notificaciones Push]]

Cron with MAC OS X

2014-07-21T13:28:30Z

Krause:

{{Cron}}
'''NOTE: This describes setting up Moodle's cron using OSX's launchd system. However, since OSX is a variant of Unix, cron is also an option. It should be noted, however, that OSX cron is actually managed by launchd.'''

The following information was originally publish by Ralf Krause in the [[Step by Step Installation on a Mac OS X Server]].

==launchd==

In Mac OS X 10.5+ you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more informations about the configurations and all parameters.

The service should get the web page http://path.to.your/moodle/admin/cron.php every few minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

'''NOTE:''' Check the [[Cron settings]] to make sure running the web version of Moodle's cron is permitted.

===Use the graphical way===
You can use Lingon (no longer supported, unfortunately) to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png|thumb|center|Lingon screenshot]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root'' with the following:

sudo chown root /Library/LaunchDaemons/moodle4mac.cron.plist

If you use a site with SSL (ie: it has an http'''s''':// protocol) you either need to have your SSL certificates listed for use by the CURL utility ([http://curl.haxx.se/docs/sslcerts.html see these docs] for more details) OR you must use the '-k' switch in addition to the '-s' switch used above; your arguments line would then read: `<string>-s -k</string>`.

That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' I will get a cron service for both.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

[[es:Cron con MAC OS X]]

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

Mac OS X Installation

2014-07-21T13:23:07Z

Krause: Redirected page to Installation on OS X

#REDIRECT [[Installation on OS X]]

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

Mac Installation

2014-07-21T13:22:32Z

Krause:

#REDIRECT [[Installation on OS X]]

Cron with MAC OS X

2014-07-21T13:15:51Z

Krause:

{{Cron}}
'''NOTE: This describes setting up Moodle's cron using OSX's launchd system. However, since OSX is a variant of Unix, cron is also an option. It should be noted, however, that OSX cron is actually managed by launchd.'''

==launchd==

In Mac OS X 10.5+ you will find the system daemon ''launchd'' for this service. This daemon offers a standardized interface to any user and all programs started automatically by the system. Please look at http://developer.apple.com/macosx/launchd.html for more informations about the configurations and all parameters.

The service should get the web page http://path.to.your/moodle/admin/cron.php every few minutes. The configuration will be done by the file named ''moodle4mac.cron.plist'' which must be placed in the system folder ''/Library/LaunchDaemons/'' ... surely you can use any other file name but it should say something about the function of the service. The extension must be ''.plist''. After any reboot of your Mac server the cron service will start automaticly because the file is placed in the correct system folder.

'''NOTE:''' Check the [[Cron settings]] to make sure running the web version of Moodle's cron is permitted.

===Use the graphical way===
You can use Lingon (no longer supported, unfortunately) to add a new daemon plist or to edit one. It produces the same text as you can write in your text editor. http://sourceforge.net/projects/lingon/files/

[[Image:macosx-lingon.png|thumb|center|Lingon screenshot]]

===Use a text editor===
Please use a text editor to write the needed file. You can open the Terminal and use the system editors vi or pico. But you can also write the text file with any GUI text editor ... I mostly use TextWrangler ... but do NOT take an editor for formatted texts like Microsoft Word or OpenOffice Writer. You must get pure text!

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>KeepAlive</key><false/>
<key>Label</key><string>moodle4mac.cron</string>
<key>ProgramArguments</key>
<array>
<string>curl</string>
<string>-s</string>
<string>http://your-server-address/moodle19/admin/cron.php</string>
</array>
<key>RunAtLoad</key><true />
<key>StartInterval</key><integer>300</integer>
<key>StandardErrorPath</key><string>/dev/null</string>
<key>StandardOutPath</key><string>/dev/null</string>
</dict>
</plist>

The label string must be the same as the file name is but without the extension ''.plist''. Save the text file ''/Library/LaunchDaemons/moodle4mac.cron.plist''. The owner of the file must be set to the system user ''root'' with the following:

sudo chown root /Library/LaunchDaemons/moodle4mac.cron.plist

If you use a site with SSL (ie: it has an http'''s''':// protocol) you either need to have your SSL certificates listed for use by the CURL utility ([http://curl.haxx.se/docs/sslcerts.html see these docs] for more details) OR you must use the '-k' switch in addition to the '-s' switch used above; your arguments line would then read: `<string>-s -k</string>`.

That's all, really!

===How to start and stop the cron service===
You can start the new cron service in the Terminal.

sudo launchctl load /Library/LaunchDaemons/moodle4mac.cron.plist

The following command would stop the service. If you want to activate changes in the cron service you need to ''unload'' and then to ''load'' the daemon again.

sudo launchctl unload /Library/LaunchDaemons/moodle4mac.cron.plist

===Only one service for two servers?===
For my server I needed to have a cron service for to instances ''moodle19'' and ''moodle20'' ... no problem ... with the typo ''moodle[19-20]'' I will get a cron service for both.

<nowiki>curl -s http://your-server-address/moodle[19-20]/admin/cron.php</nowiki>

To see if the cron service works correctly you should look at the ''access.log'' of your web server. The cron.php should be accessed every 5 minutes ... on my server for both Moodle instances ''moodle19'' and ''moodle20'' ... oh yes, it works!!

192.168.0.220 - - [30/Jul/2009:22:10:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:10:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1403
192.168.0.220 - - [30/Jul/2009:22:11:18 +0200] "OPTIONS * HTTP/1.0" 200 -
192.168.0.220 - - [30/Jul/2009:22:15:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 735
192.168.0.220 - - [30/Jul/2009:22:15:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 964
192.168.0.220 - - [30/Jul/2009:22:20:56 +0200] "GET /moodle19/admin/cron.php HTTP/1.1" 200 1136
192.168.0.220 - - [30/Jul/2009:22:20:57 +0200] "GET /moodle20/admin/cron.php HTTP/1.1" 200 1365

[[es:Cron con MAC OS X]]

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

Installation on OS X

2014-07-21T13:10:07Z

Krause:

{{Template:Installing Moodle}}

The following pages give installation information for the Mac OS X platform. This information is provided by the Moodle community and may not have been fully checked and may be out of date. It is provided in the hope that it is useful.

* [[Installation Package for OS X]] - Do not use this if you already have a web server running on your computer.
* [[Step by Step Installation on a OS X Mountain Lion Server]]

[[es:Instalación en Mac]]

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

Installation on OS X

2014-07-21T13:08:52Z

Krause:

{{Template:Installing Moodle}}

The following pages give installation information for the Mac OS X platform. This information is provided by the Moodle community and may not have been fully checked and may be out of date. It is provided in the hope that it is useful.

* [[Installation Package for OS X]] (Do not use this if you already have a web server running on your computer.)
* [[Step by Step Installation on a OS X Mountain Lion Server]]

[[es:Instalación en Mac]]

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

Installation Package for Windows

2014-07-21T13:05:59Z

Krause:

#REDIRECT [[Complete install packages for Windows]]

{{Installing Moodle}}

[[Category:Installation]]
[[Category:Windows]]

Installation Package for Windows

2014-07-21T13:05:40Z

Krause:

#REDIRECT [[Complete install packages for Windows]]

{{Installing Moodle}}

[[Caregory:Installation]]
[[Caregory:Windows]]

Installation Package for Windows

2014-07-21T13:03:08Z

Krause: Redirected page to Complete install packages for Windows

#REDIRECT [[Complete install packages for Windows]]

[[Caregory:Installation]]
[[Caregory:Windows]]

Category:Windows

2014-07-21T12:57:59Z

Krause: Created page with "Docs related specifically to running Moodle under Windows."

Docs related specifically to running Moodle under Windows.

Complete install packages for Windows

2014-07-21T12:56:17Z

Krause:

{{Installing Moodle}}
Complete install packages are available from Moodle.org's [http://download.moodle.org/windows Windows download page]. The packages are designed for new installations on a standalone computer. The complete install package can be used on a server, but '''it is not recommended that it be used as a production site'''. Please note Moodle.org's [http://download.moodle.org Standard install packages] only contain the Moodle code.

This document provides instructions for using the Windows packages. Separate instructions are available for [[Complete Install Packages for Mac OS X|Mac OS X packages]].

The complete install packages allow Moodle to be installed, along with the prerequisites that includes a web server, Apache, database, MySQL, scripting language, PHP, an administration tool, phpMyAdmin and Moodle all wrapped in the Xampp-lite shell. Several versions of the complete install package are available. The instructions on the download page provide guidance on which version is likely to be most suitable.

In short, complete install packages are designed to create a matched webserver and Moodle site on a standalone computer with minimal effort.

==System requirements==
:*256 MB RAM (minimum), 512 MB RAM (recommended)
:*160 MB free Fixed Disk (more space will be needed depending on user uploads)
:*Windows 98/ME (minimum)
:*Windows NT/2000/XP (recommended)

==Install complete package process==
The complete install package is a zip file that contains a webserver called [[Apache]], plus Moodle and Moodle's required [[MySQL]] database and [[PHP]] program.

There are three basic parts to the this install process.
#Download and unpack the complete install package.
#Start the webserver.
#Install Moodle using a web browser.

===First create file structure===
====Download the package====
[http://download.moodle.org/windows Download Windows] packed-zip file from Moodle.
[[Image:Moodle Setup zipfile.jpg|frame|center|A downloaded complete install package Windows 1.9 zip file in Windows Explorer]]

====Unpack the package====
Unpack (extract files by clicking on) the zip file you downloaded to a drive or partition of your choice. The extract process will create three files ("Start Moodle", "Stop Moodle", and "README") and a subfolder called "server".
*Do NOT rename the "server" subfolder
:''Note:'' There will also be a folder under this server subfolder, called \moodle that holds the Moodle program.

:''TIP:'' Create a folder and extract the files there. For example, you might have one folder called Moodle193 and another one called Moodle187 for different versions or purposes.

:''TIP:'' Make path to "server" subfolder simple. Best way if it will be in drive root. Like "D:\moodle193\server". A long path, especially with any strange symbols, can prevent XAMPP from working properly.

===Second - start the webserver===
Now you are ready to start the webserver. Use the "Start Moodle.exe" file which you should find in the top directory. Once the "Start Moodle.exe" program is open, don't close it; use "Stop Moodle.exe" for that purpose.

:''Note:'' These programs control both Apache and MySQL programs that operate the webserver. Some sites will individually start and stop Apache and MySQL with the Xampp bat files found in the "server" subfolder.

:''Tip:'' Alternatively, on a standalone computer with several potential webservers that might be running, you can use the "xampp_restart.exe" file in the "server" subfolder.

:''Tip:'' You can also add shortcuts to the commands that start and stop the site in your Windows "start" menu.

Now you are ready to start the Moodle installation.

:''Warning:'' Windows XP requires the msvcr71.dll library file in order to run Xampp. Installing the [http://www.microsoft.com/downloads/details.aspx?familyid=262D25E3-F589-4842-8157-034D1E7CF3A3&displaylang=en .Net 1.1 framework] (not .Net 2.0 and upper) could resolve it. You can also search for the file on Google, download it and copy it into the server/apache/bin folder.

===Third - start Moodle installation===
Start your web browser and type <nowiki> localhost, or http://127.0.0.1 or http://localhost </nowiki>in the address bar. You will either start your first time Moodle installation or if it is already installed you will enter the Moodle site's [[Front Page]] or Login screen.

[[Image:Moodle_Setup_localhost_browser.jpg|frame|center|A browser's addressbar showing "localhost". Click on the green Goto arrow will go to the installed Moodle site.]]

:''Tip:'' After Moodle installs, put the site in your "favorites" or as a "bookmark" in you browser.

====Set language====
The initial install page will be displayed after you type "localhost".

[[Image:C Install Windows 1.png|thumb|center|600px|Set initial language]]

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

====Diagnostic results====
A diagnostic report is displayed – hopefully it will look like this, if not you may need to address some issues.
[[Image:Complete Windows Install 2.png|thumb|center|546px|Moodle liked and gave a Pass ]]

*Click the “Next” button to continue.

====Moodle paths====
The paths for your Moodle installation are shown – if you are only using this as a local testing server, accept the ones that are shown on your screen.

What you enter in the "Web Address" field depends on what you intend to use the new Moodle installation for.
If you are just going to use it for local testing, then use 'http://localhost'.
If you are going to test the new installation on a LAN, and will be accessing it from other machines on that LAN, then put the private IP address or network name of the serving machine, followed by a forward slash and moodle: Web Address - http://192.168.1.1/moodle
If you are going to test the installation on the internet, then you will need to put the public ip address followed by a forward slash and moodle: http://your_ip_address/moodle or you can put your domain name here instead.

[[image:Complete install Windows 3.png|thumb|center|600px|Installation paths]]

*Click the “Next” button to continue.

====Database configuration====
*In the next fields, we enter the database settings. The fields are populated with some suggested values.

*We strongly recommend you place a user name and password in this screen. (Don't forget them).

*DO NOT USE THE “ROOT” USER WITHOUT A PASSWORD FOR PRODUCTION INSTALLATIONS AS THIS CREATES A SECURITY VULNERABILITY
[[image:Complete install Windows 4.png|thumb|center|535px|Installation's database settings]]

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

====Check server====
The install process checks the server it installed.
[[image:Complete install Windows 5.png|thumb|center|535px|Check server environment screen]]
*Click the “Next” button to continue.

====Confirm initial language pack====
Moodle will now check to see if the language pack is available for the language you selected at the first step. If it is not, Moodle will continue with the install in English.
[[image:Complete install Windows 6.png|thumb|center|535px|Language pack check]]

====Confirm config.php====
Provided the Moodle folder is writable, a message confirming the configuration has been completed will be displayed.
[[image:Complete install Windows 7.png|thumb|center|549px|Confirmation that config.php has been created]]

*Click the “ Continue” button to proceed.

====Moodle copyright & agreement====
The Moodle copyright / license notices are displayed.

[[image:Complete install Windows 8.png|thumb|center|400px|Copyright notice and agreement]]

*Click the “Yes” button to continue.

====Current release and unattended option====
The current release information is shown.
'''Check off the unattended operations box'''. This will automatically advance through many screens. If you would like to watch the install screen by screen, do not check this box and be prepared to press the "continute button" many times.

*Click the "Continue" button and wait.
[[Image:Complete install Windows 9.png|thumb|center|600px|Current release and "unattended" check box]]

====Installation modules and blocks screens====
In most cases this will be followed by a series of screens that have a continue button on the bottom. This process stops with Admin user profile settings which needs to be filled out.

====Administrator user profile====
[[Image:Complete install Windows 10.png|thumb|center|The administrator's users profile screen]]

Fill out the required fields.
*Click on "Save" to continue

====Front page settings====
The next screen is the Front Page settings page. There are two parts to it.
The first part will ask for your Full site name and a short name for the navigation bar. There is also a place for a description. You can change these later.

[[Image:Complete install Windows 11a.png|thumb|center|The Moodle sites [[Front Page]] information]]

The second part on the bottom instructs Moodle if you will disable the new user self [[authentication]] through email process. The default is to disable. This can be changed later in the [[Site administration block|site administration block]].

[[Image:Complete install Windows 11ba.png|thumb|center|500px|Determine if users can create their own profiles when they log onto the side via email self authentication]]

*Click on "Save changes" button to go to Moodle sites home page.

====Moodle on====
'''Now you are ready to Moodle !'''

[[Image:Complete install Windows 12.png|thumb|center|Blank Front page of your new site]]

The Site Administration block is on the left, the "Turn edit on" button in the upper right corner, withe the site description block just below it.

===Congratulations - Moodle has been installed===
This finishes the installation of a complete package. Type <nowiki>http://localhost</nowiki> (or what ever you set for web address earlier in the setup!) in your browser and Moodle will open.

Your next task will be to configure Moodle to meet your needs. Don't worry, it is easy to change any of the settings now that Moodle is up and running.
*Check ''Settings > Site administration'' for further links.

==More tips and cautions==
*For installation on a Windows 2000 or Windows 2003 production server it is good practice to perform a manual install (see the manual installation section in [[Windows_installation|Windows Installation]]).

*After installing the Windows package, you may wish to add additional contributed modules and plugins. Theset may involve more customization of configuration files.

*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.

== Security matters (A MUST READ!)==

As mentioned before, XAMPP is not meant for production use but only for developers
in a development environment. The way XAMPP is configured is to be open as possible
and allowing the developer anything he/she wants. For development environments this
is great but in a production environment it could be fatal. Here a list of missing security
in XAMPP:

The MySQL administrator (root) has no password.
The MySQL daemon is accessible via network.
phpMyAdmin is accessible via network.
Examples are accessible via network.

To fix most of the security weaknesses simply call the following URL:

<nowiki>http://localhost/security/</nowiki>

The root password for MySQL + phpMyAdmin and also a XAMPP directory protection can be established here.

Note that on the Windows installer package, some (all?) of these issues have been fixed already by default and the above link does not work.

If in doubt, more info is [http://www.apachefriends.org/en/faq-xampp-windows.html here]

== Apache and MySQL tweaks ==
Most of the time it is not necessary to tweak Apache or MySQL after completing the complete install package. Nor is it necessary to individually start and stop them because that is what the Xampp_start, Xampp_restart and Xammp_stop files are for.

=== Installing Apache and MySQL as services===
(This is only for NT4 | Windows 2000 | Windows XP operating systems)

\xampplite\apache\apache_installservice.bat =
==> Install Apache 2 as service

\xampplite\apache\apache_uninstallservice.bat =
==> Uninstall Apache 2 as service

\xampplite\mysql\mysql_installservice.bat =
==> Install MySQL as service

\xampplite\mysql\mysql_uninstallservice.bat =
==> Uninstall MySQL as service

==> After all Service (un)installations, please restart your system!

===Apache Notes===

You can use the apache_start and apache_stop bat files to start and stop apache from running. However the Xampp_start or Xampp_restart and Xampp_stop is recommended to turn on/off both Apache and MySQL.

====Troubleshooting====

If you find that Apache is very flaky, with the page often not loading properly or even at all (especially on localhost), try adding these lines to the end of C:\your_moodle_installer_directory\apache\conf\httpd.conf

EnableSendfile Off
EnableMMAP Off
Win32DisableAcceptEx

If You edit some .php files but browser still show old state of them, try to disable eAccelerator extension in \server\php\php.ini

[eAccelerator]
;extension=eaccelerator.dll

===MySQL notes===
Again, the recommendation to start and stop the entire webserver is to use the xampp_start or Xampp_restart and the Xampp_stop. The following maybe useful if you wish to tweak the system further. Please be careful.

(1) The MySQL server can be started by double-clicking (executing) mysql_start.bat. This file can be found in the same folder you installed xampp in, most likely this will be C:\xampplite\. The exact path to this file is X:\xampplite\mysql_start.bat, where "X" indicates the letter of the drive you unpacked xampp into.This batch file starts the MySQL server in console mode. The first intialization might take a few minutes.

Do not close the DOS window or you'll crash the server! To stop the server, please use mysql_shutdown.bat, which is located in the same directory.

(2) To use the MySQL Daemon with "innodb" for better performance,
please edit the "my" (or "my.cnf") file in the /xampplite/mysql/bin directory or for services the c:\my.cnf for windows NT/2000/XP. In that director, activate the
"innodb_data_file_path=ibdata1:30M"
statement. Attention, "innodb" is not recommended for 95/98/ME.

:To use MySQL as Service for NT/2000/XP, simply copy the "my" / "my.cnf" file to C:\my, or C:\my.cnf. Please note that this file has to be placed in C:\ (root), other locations are not permitted. Then execute the "mysql_installservice.bat" in the mysql folder.

(3) MySQL starts with standard values for the user id and the password. The preset user id is "root", the password is "" (= no password). To access MySQL via PHP with the preset values, you'll have to use the following syntax:
mysql_connect("localhost","root","");
If you want to set a password for MySQL access, please use of mysqladmin.
To set the password "secret" for the user "root", type the following:

\xampplite\mysql\bin\mysqladmin -u root password secret

After changing the password you'll have to reconfigure phpMyAdmin to use the new password, otherwise it won't be able to access the databases. To do that, open the file config.inc.php in \xampplite\phpmyadmin\ and edit the following lines:

$cfg['Servers'][$i]['user'] = 'root'; // MySQL user
$cfg['Servers'][$i]['auth_type'] = 'http'; // HTTP authentificate

So first the 'root' password is queried by the MySQL server, before phpMyAdmin may access.

Have a lot of fun! Viel Spaß! Bonne Chance!

==Vista and Windows 7==

Many people have trouble installing the packages for Windows on Vista and Windows 7.

One simple solution is to use http://bitnami.org/stack/moodle (from amazon.com).

==See also==

*[https://docs.moodle.org/19/en/Installation_guide_-_Moodle_for_Windows_on_a_USB_Memory_Stick Installation guide - Moodle 1.9 for Windows on a USB Memory Stick]
*Return to [[Windows installation]]
*[[Windows 1 computer many servers |Multiple web servers, on 1 computer]] similar to windows installation page, with some tips
*[https://docs.moodle.org/en/Windows_installation_using_XAMPP#Troubleshooting Troubleshooting]if you are running Skype.
*[[Installing_AMP]] lots of XAMPP stuff. XAMPP stands for X (cross platform), Apache, MySQL,PHP and Perl. XAMPP used in Moodle does not include Perl. MAMP stands for Mac, Apache, MySQL and PHP.
*[[Installation Package for OS X]]

[[es:Paquetes_para_Instalaci%C3%B3n_Completa]]
[[pl:Kompletne pakiety instalacyjne]]
[[de:Vollständiges Installationspaket für Windows]]

[[Category:Installation]]
[[Category:Windows]]

Mac Installation

2014-07-21T12:51:58Z

Krause: Redirected page to Installation on OS X

#REDIRECT [[Installation on OS X]]

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

Installation on OS X

2014-07-21T12:50:18Z

Krause: Created page with "{{Template:Installing Moodle}} The following pages give installation information for the Mac OSX platform. This information is provided by the Moodle community and may not ha..."

{{Template:Installing Moodle}}

The following pages give installation information for the Mac OSX platform. This information is provided by the Moodle community and may not have been fully checked and may be out of date. It is provided in the hope that it is useful.

* [[Installation Package for OS X]] (Do not use this if you already have a web server running on your computer.)
* [[Step by Step Installation on a OS X Mountain Lion Server]]

[[es:Instalación en Mac]]

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

Mac Installation

2014-07-21T12:48:43Z

Krause:

{{Template:Installing Moodle}}

The following pages give installation information for the Mac OSX platform. This information is provided by the Moodle community and may not have been fully checked and may be out of date. It is provided in the hope that it is useful.

* [[Installation Package for OS X]] (Do not use this if you already have a web server running on your computer.)
* [[Step by Step Installation on a OS X Mountain Lion Server]]

[[es:Instalación en Mac]]

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

Step by Step Installation on a OS X Mountain Lion Server

2014-07-21T12:46:05Z

Krause:

{{Installing Moodle}}
== Overview ==
This guide shows all steps for installing Moodle on Mountain Lion running OS X Server. This server is a commercial product. OS X Server can be used as an inhouse server as well as an internet server. You will find all documentations about the web server on the Apple support pages.

This guide DOES NOT show you how to setup Moodle on MAMP or XAMPP. If you do not have a web server currently running on your computer, please see [[Installation Package for OS X]] that can be downloaded from http://download.moodle.org/macosx/

Internet-accessible or "live" servers should use a more robust and secure implementation than provided by MAMP or XAMPP for OS X.

Please feel free to add comments to this page about any edits you believe should be made.

== Installation Requirements ==

From Apple's [http://www.apple.com/osx/server/specs/ Server Requirements Webpage]:
+ Mac Computer
+ 2GB of memory.
+ 10GB of available disk space; some features require additional disk space.

Additional Requirements:
+ Hard Disk: 500 MB free
+ OS X Mountain Lion (10.8+, I'm using 10.8.2 Build 12C3012)
+ OS X Server (2+, I am using 2.2.1 Build 12T162)

== Assumptions ==
All instructions will be written with following assumptions:
* The administrator is comfortable using Finder, Safari, and standard text editors in OS X.
* The administrator has already performed the initial configuration of OS X Mountain Lion and OS X Server.
* The administrator has not performed anything more than the initial configurations.*
* The administrator is comfortable using the following commands in terminal: cd, ls, vim, sudo.

<nowiki>*</nowiki>Performing these steps for the first time on a production server is NOT recommended. Always test software on a development server.

== Before we begin ==
These instructions have been written based on my experience setting up Moodle in a highly customized server. I will test all instructions in a clean environment once I have more time availability. Anyone who would like to test these instructions and report back any errors, please leave a comment with the section and error. Please do not test these instructions on a production machine.

== Copying Moodle to the Proper Directory ==
# Download the latest version of Moodle from http://moodle.org/downloads (it should unzip automatically into your downloads folder)
# Copy/Move the "moodle" directory to /Library/Server/Web/Data/Sites/ (make sure you put the folder, not the contents)

== Creating the Moodle Data Directory ==
The standard location for all shared data is the "Shared Items" folder at the root of OS X, so we are going to place the Moodle Data directory in "Shared Items"
# In finder, go to /Shared Items (You can use the Go->Go To Folder command)
# Create a new folder called MoodleData

== Setting the proper permissions ==
Open Terminal.app
To setup the Moodle folder run the following commands:
<pre>cd /Library/Server/Web/Data/Sites/
sudo chown -R _www moodle/
</pre>
To setup the MoodleData folder fun the following commands:
<pre>cd /Shared\ Items/
sudo chmod -R a=rwx MoodleData/
</pre>
Quit Terminal.app

== Configuring the Websites Service in OS X Server ==
# Open Server.app
# In the sidebar, click Websites.
# Enable the checkbox next to "Enable PHP web applications"
# Create a new website by clicking the plus (+) in the bottom left:
## Fill in the domain name.
## Choose an IP Address if you want it to be different than Any.
## If you want the connection to be secured* (using SSL) choose an SSL Certificate that matches your domain name from above.
## Select your sites directory:
### In "Store Site Files In" choose "Other"
### Navigate to /Library/Server/Web/Data/Sites/
### Click "moodle"
### Press the "Choose" button.
## Edit Advanced Settings:
### Scroll down, and choose "Edit Advanced Settings..."
### Check the box next to "Enable Server Side Includes"
### Press the "OK" button
## Press the "Done" button
# Enable the Websites service by changing the toggle switch from OFF to ON
<nowiki>*</nowiki>All production servers should be secured and have a trusted SSL certificate. If you are storing real student data and you do not use SSL, your users will be passing their username and password in clear text.

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

Step by Step Installation on a OS X Mountain Lion Server

2014-07-21T12:44:33Z

Krause:

{{Installing Moodle}}
== Overview ==
This guide shows all steps for installing Moodle on Mountain Lion running OS X Server. This server is a commercial product. OS X Server can be used as an inhouse server as well as an internet server. You will find all documentations about the web server on the Apple support pages.

This guide DOES NOT show you how to setup Moodle on MAMP or XAMPP. If you do not have a web server currently running on your computer, please see [[Complete Install Packages for Mac OS X]] that can be downloaded from http://download.moodle.org/macosx/

Internet-accessible or "live" servers should use a more robust and secure implementation than provided by MAMP or XAMPP for OS X.

Please feel free to add comments to this page about any edits you believe should be made.

== Installation Requirements ==

From Apple's [http://www.apple.com/osx/server/specs/ Server Requirements Webpage]:
+ Mac Computer
+ 2GB of memory.
+ 10GB of available disk space; some features require additional disk space.

Additional Requirements:
+ Hard Disk: 500 MB free
+ OS X Mountain Lion (10.8+, I'm using 10.8.2 Build 12C3012)
+ OS X Server (2+, I am using 2.2.1 Build 12T162)

== Assumptions ==
All instructions will be written with following assumptions:
* The administrator is comfortable using Finder, Safari, and standard text editors in OS X.
* The administrator has already performed the initial configuration of OS X Mountain Lion and OS X Server.
* The administrator has not performed anything more than the initial configurations.*
* The administrator is comfortable using the following commands in terminal: cd, ls, vim, sudo.

<nowiki>*</nowiki>Performing these steps for the first time on a production server is NOT recommended. Always test software on a development server.

== Before we begin ==
These instructions have been written based on my experience setting up Moodle in a highly customized server. I will test all instructions in a clean environment once I have more time availability. Anyone who would like to test these instructions and report back any errors, please leave a comment with the section and error. Please do not test these instructions on a production machine.

== Copying Moodle to the Proper Directory ==
# Download the latest version of Moodle from http://moodle.org/downloads (it should unzip automatically into your downloads folder)
# Copy/Move the "moodle" directory to /Library/Server/Web/Data/Sites/ (make sure you put the folder, not the contents)

== Creating the Moodle Data Directory ==
The standard location for all shared data is the "Shared Items" folder at the root of OS X, so we are going to place the Moodle Data directory in "Shared Items"
# In finder, go to /Shared Items (You can use the Go->Go To Folder command)
# Create a new folder called MoodleData

== Setting the proper permissions ==
Open Terminal.app
To setup the Moodle folder run the following commands:
<pre>cd /Library/Server/Web/Data/Sites/
sudo chown -R _www moodle/
</pre>
To setup the MoodleData folder fun the following commands:
<pre>cd /Shared\ Items/
sudo chmod -R a=rwx MoodleData/
</pre>
Quit Terminal.app

== Configuring the Websites Service in OS X Server ==
# Open Server.app
# In the sidebar, click Websites.
# Enable the checkbox next to "Enable PHP web applications"
# Create a new website by clicking the plus (+) in the bottom left:
## Fill in the domain name.
## Choose an IP Address if you want it to be different than Any.
## If you want the connection to be secured* (using SSL) choose an SSL Certificate that matches your domain name from above.
## Select your sites directory:
### In "Store Site Files In" choose "Other"
### Navigate to /Library/Server/Web/Data/Sites/
### Click "moodle"
### Press the "Choose" button.
## Edit Advanced Settings:
### Scroll down, and choose "Edit Advanced Settings..."
### Check the box next to "Enable Server Side Includes"
### Press the "OK" button
## Press the "Done" button
# Enable the Websites service by changing the toggle switch from OFF to ON
<nowiki>*</nowiki>All production servers should be secured and have a trusted SSL certificate. If you are storing real student data and you do not use SSL, your users will be passing their username and password in clear text.

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

Step by Step Installation on a OS X Mountain Lion Server

2014-07-21T12:42:00Z

Krause:

{{Installing Moodle}}
== Overview ==
This guide shows all steps for installing Moodle on Mountain Lion running OS X Server. This server is a commercial product. OS X Server can be used as an inhouse server as well as an internet server. You will find all documentations about the web server on the Apple support pages.

This guide DOES NOT show you how to setup Moodle on MAMP or XAMPP. If you do not have a web server currently running on your computer, please see [[Complete Install Packages for Mac OS X]] that can be downloaded from http://download.moodle.org/macosx/

Internet-accessible or "live" servers should use a more robust and secure implementation than provided by MAMP or XAMPP for OS X.

Please feel free to add comments to this page about any edits you believe should be made.

== Installation Requirements ==

From Apple's [http://www.apple.com/osx/server/specs/ Server Requirements Webpage]:
+ Mac Computer
+ 2GB of memory.
+ 10GB of available disk space; some features require additional disk space.

Additional Requirements:
+ Hard Disk: 500 MB free
+ OS X Mountain Lion (10.8+, I'm using 10.8.2 Build 12C3012)
+ OS X Server (2+, I am using 2.2.1 Build 12T162)

== Assumptions ==
All instructions will be written with following assumptions:
* The administrator is comfortable using Finder, Safari, and standard text editors in OS X.
* The administrator has already performed the initial configuration of OS X Mountain Lion and OS X Server.
* The administrator has not performed anything more than the initial configurations.*
* The administrator is comfortable using the following commands in terminal: cd, ls, vim, sudo.

<nowiki>*</nowiki>Performing these steps for the first time on a production server is NOT recommended. Always test software on a development server.

== Before we begin ==
These instructions have been written based on my experience setting up Moodle in a highly customized server. I will test all instructions in a clean environment once I have more time availability. Anyone who would like to test these instructions and report back any errors, please leave a comment with the section and error. Please do not test these instructions on a production machine.

== Copying Moodle to the Proper Directory ==
# Download the latest version of Moodle from http://moodle.org/downloads (it should unzip automatically into your downloads folder)
# Copy/Move the "moodle" directory to /Library/Server/Web/Data/Sites/ (make sure you put the folder, not the contents)

== Creating the Moodle Data Directory ==
The standard location for all shared data is the "Shared Items" folder at the root of OS X, so we are going to place the Moodle Data directory in "Shared Items"
# In finder, go to /Shared Items (You can use the Go->Go To Folder command)
# Create a new folder called MoodleData

== Setting the proper permissions ==
Open Terminal.app
To setup the Moodle folder run the following commands:<pre>
cd /Library/Server/Web/Data/Sites/
sudo chown -R _www moodle/
</pre>
To setup the MoodleData folder fun the following commands:
<pre>
cd /Shared\ Items/
sudo chmod -R a=rwx MoodleData/
</pre>
Quit Terminal.app

== Configuring the Websites Service in OS X Server ==
# Open Server.app
# In the sidebar, click Websites.
# Enable the checkbox next to "Enable PHP web applications"
# Create a new website by clicking the plus (+) in the bottom left:
## Fill in the domain name.
## Choose an IP Address if you want it to be different than Any.
## If you want the connection to be secured* (using SSL) choose an SSL Certificate that matches your domain name from above.
## Select your sites directory:
### In "Store Site Files In" choose "Other"
### Navigate to /Library/Server/Web/Data/Sites/
### Click "moodle"
### Press the "Choose" button.
## Edit Advanced Settings:
### Scroll down, and choose "Edit Advanced Settings..."
### Check the box next to "Enable Server Side Includes"
### Press the "OK" button
## Press the "Done" button
# Enable the Websites service by changing the toggle switch from OFF to ON
<nowiki>*</nowiki>All production servers should be secured and have a trusted SSL certificate. If you are storing real student data and you do not use SSL, your users will be passing their username and password in clear text.

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

Git for Mac

2014-07-21T12:38:27Z

Krause: Redirected page to Git for OS X

#REDIRECT [[Git for OS X]]

Git for OS X

2014-07-21T12:36:44Z

Krause: Created page with "This GIT installer for Mac OS X is part of the installation package [http://download.moodle.org/macosx/ Moodle4Mac] by Ralf Krause ==Code== #! /bin/sh # # This GIT insta..."

This GIT installer for Mac OS X is part of the installation package [http://download.moodle.org/macosx/ Moodle4Mac] by Ralf Krause

==Code==

#! /bin/sh
#
# This GIT installer for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20140714 - Ralf Krause
#

echo
echo "+--------------------------------------------+"
echo "| GIT updater for your local Moodle server"
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs

if ! test -e moodle27/.git ; then
## the first git update must get everything including .git
git clone --depth 1 -b MOODLE_27_STABLE git://github.com/moodle/moodle.git moodle27-git
if test -e moodle27 ; then
if test -e moodle27/config.php ; then
cp moodle27/config.php moodle27-git/.
fi
DATE=`date +%Y%m%d-%H%M`
mv moodle27 moodle27-$DATE
fi
mv moodle27-git moodle27
## the old folder can be deleted now
## if you want to do this please remove '##' from the following line
## sudo rm -R moodle27-*
else
## the next git update only gets the new files
cd moodle27
git pull
cd ..
fi

==See also==
[[Git for Administrators]]

[[Category:Installation]]
[[Category:Mac OS X]]
[[es:Git para Mac]]

Git for Mac

2014-07-21T12:35:05Z

Krause:

Complete Install Packages for Mac OS X

2014-07-21T12:29:38Z

Krause: Deleted the old wiki page and redirected to a newer page with a different title

#REDIRECT [[Installation Package for OS X]]

{{Installing Moodle}}
[[Category:Mac OS X]]

[[de:Installationspaket für OS X]]
[[es:Paquetes de Instalación Completos para Mac OS X]]

Installation Package for OS X

2014-07-21T12:24:55Z

Krause: Created page with "{{Installing Moodle}} ==Summary== The complete install packages for Mac OS X are named Moodle4Mac and allow a very easy way to install Moodle on your Mac computer (laptop, des..."

{{Installing Moodle}}
==Summary==
The complete install packages for Mac OS X are named Moodle4Mac and allow a very easy way to install Moodle on your Mac computer (laptop, desktop, server). Moodle4Mac is available from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X]. You will find other downloads for Linux and Window Operating Systems that may involve more customization of configuration files.

Moodle4Mac is based on the software MAMP. MAMP contains everything that is necessary for the operation of Moodle, the Apache web server, MySQL database and PHP scripting language. For the various Moodle versions you can get different installation packages. Please check which Moodle your institution (school, college, university, company) uses on its server so that you can swap your materials between the two platforms easily.

Of course, you can install the latest Moodle development version to find everything about upcoming opportunities and changes. However, please remember that a developer version is not yet a finished product, and that a development version may contain errors.

Moodle4Mac is not intended to be used as a productive server on the Internet. It is only intended for installation on a local computer to test and develop. The configuration is not optimized for security. If you want to run Moodle on an OS X server connected to the internet, please read the instructions [https://docs.moodle.org/en/Step_by_Step_Installation_on_a_Mac_OS_X_Server Step by step installation on a OS X Server].

==System requirements==
+ Apple OS X Computer
+ iMac, Mac mini, MacBook, MacBook Air, Mac Pro
+ Processor: Intel x86_64 (i5, i7, Xeon, Core2Duo)
+ RAM: 4 GB or better
+ Hard Disk: 1 GB free
+ System Software: OS X 10.6, 10.7, 10.8, 10.9

==Download and install ==
'''Step 1:''' Download the disk image '''Moodle4Mac-MAMP.dmg''' from the web site [http://download.moodle.org/macosx/ Moodle packages for Mac OS X] . You will find various image files for the different Moodle versions on this web site.

'''Step 2:''' Double click the disk image '''Moodle4Mac-MAMP.dmg''' to mount the installation disk.

[[Image:Moodle4Mac_1.png|500px]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac OS X, Apache, MySQL, PHP). MAMP does not save parameters in a registry or in system variables. If you want to delete Moodle4Mac you only need to move the MAMP folder into the Trash. For more information about MAMP please look at the [http://mamp.info/ MAMP project page].

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

[[Image:Moodle4Mac_2.png|500px]]

'''Step 5:''' Double click the MAMP icon to start the server.

[[Image:Moodle4Mac_3.png|500px]]

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

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

[[Image:Moodle4Mac_4.png|900px]]

==Language packages==

By default Moodle4Mac is delivered in English, any other language must be loaded. The german standard package ''de'' translates all text strings to german, the additional package ''de_du'' adds the informal conversation ''du'', the additional package ''de_kids'' provides scholastic simplifications.

The direct link for the language import is http://localhost:8888/moodle28/admin/tool/langimport/

[[Image:Moodle4Mac_5.png|900px]]

After importing the additional language pack, the settings for the default language for the user account '''admin''' can be switched to German. Only it you change the setting you will find the german menus and german settings dialogs your Moodle. Of course, all text in the text boxes on the home page and in the two preloaded courses Moodle4Mac About and How to update as they were originally entered ... if you like, you can change these texts like ....

==Completely backup your server==
Just as you installed Moodle4Mac the first time on your computer, you can backup a customized system completely. Because all files and configurations are stored within the directory MAMP, you can easily backup your MAMP directory to an external disk. Your Moodle will be frozen together with all settings and all the courses, and it can be recovered at any time in the same form.

First stop all server processes like httpd and mysqld, then exit the MAMP program. After everything stopped you can copy or move the MAMP directory. If you want to transfer MAMP to one or more other computers, you will create a ZIP archive containing the MAMP directory. This ZIP archive can be copied anywhere ... to an USB memory, to a web server, on a burned CD ...

The target computer must be a Mac. On this Mac, unpack the ZIP archive and move the MAMP folder to the Application folder ... done! Everything is going exactly as in section download and installation. In this way you can prepare your Moodle for a presentation or a training lab, and you can distribute it.

[[Image:Moodle4Mac_ZIP.png|500px]]

==Server in your local network==

In various workshops we used Moodle4Mac as a quick server installation for our local network. Make sure that you change the passwords for Moodle and MySQL before you allow access to this server ... otherwise, you'll be amazed how creative your user group can be. Please read the safety instructions of Moodle4Mac.

In this section you will see all required settings to use the server in the local network. Only three steps are required. The first step is to change one line in the config.php for Moodle. In the second step you need to adjust the base address in Moodle. And in your third step you open the firewall for ''httpd''.

To get your Moodle to another computer in your local network your Mac must be clearly addressable. You may use a fixed IP address or a DNS name. In local networks usually ip addresses of the private sections 10.xxx , 172.xxx , or 192.168.xx are assigned. If your Moodle4Mac gets an ip address this address must never change. Please do not use any static ip address if you do not know exactly what you do ... in case of doubt ask the administrator of the local network.

You can't use Moodle4Mac as a local server which is intended to work on different networks.

====Edit config.php====
For the following your computer should be a Mac in a computer lab. For this example it has the the fixed ip address 192.168.0.200. You must edit now the configuration ''/Applications/MAMP/htdocs/moodle24/config.php'' and change the wwwroot from ''localhost'' to ''192.168.0.200''. You must use your own address for your own network!!

After your changes you should get your Moodle with the address http://192.168.0.200/moodle24/

<pre><?php /// Moodle configuration file

unset($CFG);
global $CFG;
$CFG = new stdClass();

$CFG->dbtype = 'mysqli';
$CFG->dblibrary = 'native';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle28';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->prefix = 'mdl_';
$CFG->dboptions = array (
'dbpersit' => 0,
'dbport' => '',
'dbsocket' => 1,
);

// localhost wird auf 192.168.0.200 geändert
// $CFG->wwwroot = 'http://localhost:8888/moodle28';
$CFG->wwwroot = 'http://192.168.0.200:8888/moodle28';
$CFG->dataroot = '/Applications/MAMP/data/moodle28';
$CFG->admin = 'admin';

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

require_once(dirname(__FILE__) . '/lib/setup.php');

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

====Replace internal links in Moodle====
The original base address ''localhost'' is stored in many places within the database, your Moodle will not work properly with the modified base address. But images can not be displayed because they are accessible only from their correct address. From your local computer you might not see the problems but if you are outside on a computer getting access to the site.

Moodle has a tool that allows you to replace the database entries from http://localhost:8888/moodle24/ to http://192.168.0.200:8888/moodle28/ .

[[Image:Moodle4Mac_6.png|900px]]

You call this tool via the address http://192.168.0.200:8888/moodle28/admin/tool/replace/

No ... there is no menu option for it, probably because at thoughtless action with this tool also can shred the database ... in the first field enter http://localhost:8888/moodle28/, in the second field http://192.168.0.200:8888/moodle28/ (or the ip address that you have assigned in your installation). Use the correct spelling in both fields! With the hook you acknowledge that you know about the risk ...

====Open the firewall====
The firewall in OS X 10.6, 10.7, 10.8, and 10.9 can be enabled and disabled the ''System Preferences > Security > Firewall''. If the firewall is disabled, although Moodle4Mac works without further settings in the network, but your computer is vulnerable to all requests from the outside ... the latter you should not do!

[[Image:Moodle4Mac_Firewall1.png|520px]]

The the system firewall of OS X is a packet filter that determines for each program if a data packet should be passed or blocked. If the firewall is enabled every program must be entered on a list to respond to requests from outside. Moodle4Mac (or MAMP) uses the httpd program to deliver the sites. You will find httpd in the MAMP folder ... the path is ''/Application/MAMP/Library/bin/httpd''. To enter httpd into the whitelist of the firewall you must click forward on this path ... no idea if there would be a configuration file which you can edit.

You need to get this setting for the firewall only once. If httpd is approved then all computers in your local network can access to Moodle ... by the way it is not important which is used by httpd ... port 8888 or port 80.

Do not open the firewall for mysqld because Moodle itself gets a connection to mysql on the server but no user should communicate with mysql directly from the client.

[[Image:Moodle4Mac_Firewall2.png|520px]]

====Connect Moodle from your local network====
Your web server can be connected with the url http://192.168.0.200:8888/moodle28/ in your local network, where 192.168.0.200 is an example address which your Mac got from the local router. Usually such local numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x and you will be able to do your settings even if they differ from this description.

When you got all settings right then all users from any computer in your network will see your Moodle via http://192.168.0.200:8888/moodle28/. And there will be no problem with any operating system.

[[Image:Moodle4Mac_7.png|900px]]

====Connect Moodle from your local network with mobile devices====
The following images show the locale Moodle site with an iPad and an iPhone.

[[image:Moodle4Mac_8.png|890px]]

[[image:Moodle4Mac_9.png|490px]]

==Some words about the security ...==
====MAMP is not secure!====
MAMP can be used for testing and developing web sites locally on a Mac computer. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. MAMP is prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments. Be careful!

====How to secure MAMP?====
Moodle4Mac is a preconfigured package where all the default settings are accessible. The password for the Moodle admin user is known and must necessarily be changed.

But please do not think that this should be enough! Your Moodle could also be attacked through the back door via the database. You definitely need to change the passwords of the database users root and moodle, because these passwords are known. Otherwise any hacker could change the password of the user account admin to get full access to all the information in Moodle. Alternatively, the hacker could also assign another user account to full admin access and he would be able to read all informations ... the main admin would probably not notice of such a change. It is also possible to delete the database completely if you know the root access to the database so that all information could be lost in this case.

====Secure connections with HTTPS====
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==
It is very simple to update your locally installed Moodle. You start the update with a double click and everything happens automatically. All courses rest in Moodle. You do not need to renew your local Moodle completely ... you only get the new Moodle files.

====Update the local Moodle via Git====
Make sure that the Git program is installed on your Mac (see instructions below). You also need an Internet connection because the files are downloaded from the Moodle update server. A double click on the icon UpdateMoodle.sh starts the script and updating occurs automatically. That's really all ... could it be easier?

[[Image:Moodle4Mac_Update1.png]]

The Git program connects to the Moodle server and controls which files are new, which have changed and which have been deleted. The transmission time depends on the internet connection. With Git only really necessary files will be transmitted. If the transfer takes too long, you can abort the process with <ctrl>-c. You can easily start the update again later.

[[Image:Moodle4Mac_Update2.png|550px]]

  

====Script control ... looking inside ... ====

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor, e.g. TextWrangler.

It is only a text file but it uses a OS X feature to open and execute the script with the Terminal program. You don't need to learn anything ... doubleclick to update everything.

<pre>
#! /bin/sh
#
# This GIT installer for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20140714 - Ralf Krause
#

echo
echo "+--------------------------------------------+"
echo "| GIT updater for your local Moodle server"
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs

if ! test -e moodle28/.git ; then
## the first git update must get everything including .git
git clone --depth 1 -b master git://github.com/moodle/moodle.git moodle28-git
if test -e moodle28 ; then
if test -e moodle28 ; then
if test -e moodle28/config.php ; then
cp moodle28/config.php moodle28-git/.
fi
DATE=`date +%Y%m%d-%H%M`
mv moodle28 moodle28-$DATE
fi
mv moodle28-git moodle28
fi
## the old folder can be deleted now
## if you want to do this please remove '##' from the following line
## sudo rm -R moodle28-*
else
## the next git update only gets the new files
cd moodle28
git pull
cd ..
fi
</pre>

The different versions of the script UpdateMoodle.sh only differ in two parameters ... first we need to know the right folder for Moodle and second we must use the correct git tag for the Moodle version. The shown script upgrades Moodle 2.8.
* Moodle 2.0 uses MOODLE_20_STABLE
* Moodle 2.1 uses MOODLE_21_STABLE
* Moodle 2.2 uses MOODLE_22_STABLE
* Moodle 2.3 uses MOODLE_23_STABLE
* Moodle 2.4 uses MOODLE_24_STABLE
* Moodle 2.5 uses MOODLE_25_STABLE
* Moodle 2.6 uses MOODLE_26_STABLE
* Moodle 2.7 uses MOODLE_27_STABLE
* Moodle 2.8dev uses master

====Install Git====

Download the Git program from http://git-scm.com/download/ ... it's free and open source.

[[Image:Moodle4Mac_Git1.png]]
  

Open the disk image and doubleclick the installer git-xxx-osx.pkg. If you want to know more about Git then read the Git documentation on their web site ... but if you only want to update Moodle the script '''UpdateMoodle.sh''' should also work without reading

[[Image:Moodle4Mac_Git2.png|500px]]
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [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]

[[Category:Mac OS X]]

[[de:Installationspaket für OS X]]
[[es:Paquetes de Instalación Completos para Mac OS X]]

Complete Install Packages for Mac OS X

2014-07-21T12:21:11Z

Krause: /* Some words about the security ... */

{{Installing Moodle}}
==Summary==
The complete install packages for Mac OS X are named Moodle4Mac and allow a very easy way to install Moodle on your Mac computer (laptop, desktop, server). Moodle4Mac is available from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X]. You will find other downloads for Linux and Window Operating Systems that may involve more customization of configuration files.

Moodle4Mac is based on the software MAMP. MAMP contains everything that is necessary for the operation of Moodle, the Apache web server, MySQL database and PHP scripting language. For the various Moodle versions you can get different installation packages. Please check which Moodle your institution (school, college, university, company) uses on its server so that you can swap your materials between the two platforms easily.

Of course, you can install the latest Moodle development version to find everything about upcoming opportunities and changes. However, please remember that a developer version is not yet a finished product, and that a development version may contain errors.

Moodle4Mac is not intended to be used as a productive server on the Internet. It is only intended for installation on a local computer to test and develop. The configuration is not optimized for security. If you want to run Moodle on an OS X server connected to the internet, please read the instructions [https://docs.moodle.org/en/Step_by_Step_Installation_on_a_Mac_OS_X_Server Step by step installation on a OS X Server].

==System requirements==
+ Apple OS X Computer
+ iMac, Mac mini, MacBook, MacBook Air, Mac Pro
+ Processor: Intel x86_64 (i5, i7, Xeon, Core2Duo)
+ RAM: 4 GB or better
+ Hard Disk: 1 GB free
+ System Software: OS X 10.6, 10.7, 10.8, 10.9

==Download and install ==
'''Step 1:''' Download the disk image '''Moodle4Mac-MAMP.dmg''' from the web site [http://download.moodle.org/macosx/ Moodle packages for Mac OS X] . You will find various image files for the different Moodle versions on this web site.

'''Step 2:''' Double click the disk image '''Moodle4Mac-MAMP.dmg''' to mount the installation disk.

[[Image:Moodle4Mac_1.png|500px]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac OS X, Apache, MySQL, PHP). MAMP does not save parameters in a registry or in system variables. If you want to delete Moodle4Mac you only need to move the MAMP folder into the Trash. For more information about MAMP please look at the [http://mamp.info/ MAMP project page].

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

[[Image:Moodle4Mac_2.png|500px]]

'''Step 5:''' Double click the MAMP icon to start the server.

[[Image:Moodle4Mac_3.png|500px]]

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

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

[[Image:Moodle4Mac_4.png|900px]]

==Language packages==

By default Moodle4Mac is delivered in English, any other language must be loaded. The german standard package ''de'' translates all text strings to german, the additional package ''de_du'' adds the informal conversation ''du'', the additional package ''de_kids'' provides scholastic simplifications.

The direct link for the language import is http://localhost:8888/moodle28/admin/tool/langimport/

[[Image:Moodle4Mac_5.png|900px]]

After importing the additional language pack, the settings for the default language for the user account '''admin''' can be switched to German. Only it you change the setting you will find the german menus and german settings dialogs your Moodle. Of course, all text in the text boxes on the home page and in the two preloaded courses Moodle4Mac About and How to update as they were originally entered ... if you like, you can change these texts like ....

==Completely backup your server==
Just as you installed Moodle4Mac the first time on your computer, you can backup a customized system completely. Because all files and configurations are stored within the directory MAMP, you can easily backup your MAMP directory to an external disk. Your Moodle will be frozen together with all settings and all the courses, and it can be recovered at any time in the same form.

First stop all server processes like httpd and mysqld, then exit the MAMP program. After everything stopped you can copy or move the MAMP directory. If you want to transfer MAMP to one or more other computers, you will create a ZIP archive containing the MAMP directory. This ZIP archive can be copied anywhere ... to an USB memory, to a web server, on a burned CD ...

The target computer must be a Mac. On this Mac, unpack the ZIP archive and move the MAMP folder to the Application folder ... done! Everything is going exactly as in section download and installation. In this way you can prepare your Moodle for a presentation or a training lab, and you can distribute it.

[[Image:Moodle4Mac_ZIP.png|500px]]

==Server in your local network==

In various workshops we used Moodle4Mac as a quick server installation for our local network. Make sure that you change the passwords for Moodle and MySQL before you allow access to this server ... otherwise, you'll be amazed how creative your user group can be. Please read the safety instructions of Moodle4Mac.

In this section you will see all required settings to use the server in the local network. Only three steps are required. The first step is to change one line in the config.php for Moodle. In the second step you need to adjust the base address in Moodle. And in your third step you open the firewall for ''httpd''.

To get your Moodle to another computer in your local network your Mac must be clearly addressable. You may use a fixed IP address or a DNS name. In local networks usually ip addresses of the private sections 10.xxx , 172.xxx , or 192.168.xx are assigned. If your Moodle4Mac gets an ip address this address must never change. Please do not use any static ip address if you do not know exactly what you do ... in case of doubt ask the administrator of the local network.

You can't use Moodle4Mac as a local server which is intended to work on different networks.

====Edit config.php====
For the following your computer should be a Mac in a computer lab. For this example it has the the fixed ip address 192.168.0.200. You must edit now the configuration ''/Applications/MAMP/htdocs/moodle24/config.php'' and change the wwwroot from ''localhost'' to ''192.168.0.200''. You must use your own address for your own network!!

After your changes you should get your Moodle with the address http://192.168.0.200/moodle24/

<pre><?php /// Moodle configuration file

unset($CFG);
global $CFG;
$CFG = new stdClass();

$CFG->dbtype = 'mysqli';
$CFG->dblibrary = 'native';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle28';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->prefix = 'mdl_';
$CFG->dboptions = array (
'dbpersit' => 0,
'dbport' => '',
'dbsocket' => 1,
);

// localhost wird auf 192.168.0.200 geändert
// $CFG->wwwroot = 'http://localhost:8888/moodle28';
$CFG->wwwroot = 'http://192.168.0.200:8888/moodle28';
$CFG->dataroot = '/Applications/MAMP/data/moodle28';
$CFG->admin = 'admin';

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

require_once(dirname(__FILE__) . '/lib/setup.php');

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

====Replace internal links in Moodle====
The original base address ''localhost'' is stored in many places within the database, your Moodle will not work properly with the modified base address. But images can not be displayed because they are accessible only from their correct address. From your local computer you might not see the problems but if you are outside on a computer getting access to the site.

Moodle has a tool that allows you to replace the database entries from http://localhost:8888/moodle24/ to http://192.168.0.200:8888/moodle28/ .

[[Image:Moodle4Mac_6.png|900px]]

You call this tool via the address http://192.168.0.200:8888/moodle28/admin/tool/replace/

No ... there is no menu option for it, probably because at thoughtless action with this tool also can shred the database ... in the first field enter http://localhost:8888/moodle28/, in the second field http://192.168.0.200:8888/moodle28/ (or the ip address that you have assigned in your installation). Use the correct spelling in both fields! With the hook you acknowledge that you know about the risk ...

====Open the firewall====
The firewall in OS X 10.6, 10.7, 10.8, and 10.9 can be enabled and disabled the ''System Preferences > Security > Firewall''. If the firewall is disabled, although Moodle4Mac works without further settings in the network, but your computer is vulnerable to all requests from the outside ... the latter you should not do!

[[Image:Moodle4Mac_Firewall1.png|520px]]

The the system firewall of OS X is a packet filter that determines for each program if a data packet should be passed or blocked. If the firewall is enabled every program must be entered on a list to respond to requests from outside. Moodle4Mac (or MAMP) uses the httpd program to deliver the sites. You will find httpd in the MAMP folder ... the path is ''/Application/MAMP/Library/bin/httpd''. To enter httpd into the whitelist of the firewall you must click forward on this path ... no idea if there would be a configuration file which you can edit.

You need to get this setting for the firewall only once. If httpd is approved then all computers in your local network can access to Moodle ... by the way it is not important which is used by httpd ... port 8888 or port 80.

Do not open the firewall for mysqld because Moodle itself gets a connection to mysql on the server but no user should communicate with mysql directly from the client.

[[Image:Moodle4Mac_Firewall2.png|520px]]

====Connect Moodle from your local network====
Your web server can be connected with the url http://192.168.0.200:8888/moodle28/ in your local network, where 192.168.0.200 is an example address which your Mac got from the local router. Usually such local numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x and you will be able to do your settings even if they differ from this description.

When you got all settings right then all users from any computer in your network will see your Moodle via http://192.168.0.200:8888/moodle28/. And there will be no problem with any operating system.

[[Image:Moodle4Mac_7.png|900px]]

====Connect Moodle from your local network with mobile devices====
The following images show the locale Moodle site with an iPad and an iPhone.

[[image:Moodle4Mac_8.png|890px]]

[[image:Moodle4Mac_9.png|490px]]

==Some words about the security ...==
====MAMP is not secure!====
MAMP can be used for testing and developing web sites locally on a Mac computer. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. MAMP is prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments. Be careful!

====How to secure MAMP?====
Moodle4Mac is a preconfigured package where all the default settings are accessible. The password for the Moodle admin user is known and must necessarily be changed.

But please do not think that this should be enough! Your Moodle could also be attacked through the back door via the database. You definitely need to change the passwords of the database users root and moodle, because these passwords are known. Otherwise any hacker could change the password of the user account admin to get full access to all the information in Moodle. Alternatively, the hacker could also assign another user account to full admin access and he would be able to read all informations ... the main admin would probably not notice of such a change. It is also possible to delete the database completely if you know the root access to the database so that all information could be lost in this case.

====Secure connections with HTTPS====
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==
It is very simple to update your locally installed Moodle. You start the update with a double click and everything happens automatically. All courses rest in Moodle. You do not need to renew your local Moodle completely ... you only get the new Moodle files.

====Update the local Moodle via Git====
Make sure that the Git program is installed on your Mac (see instructions below). You also need an Internet connection because the files are downloaded from the Moodle update server. A double click on the icon UpdateMoodle.sh starts the script and updating occurs automatically. That's really all ... could it be easier?

[[Image:Moodle4Mac_Update1.png]]

The Git program connects to the Moodle server and controls which files are new, which have changed and which have been deleted. The transmission time depends on the internet connection. With Git only really necessary files will be transmitted. If the transfer takes too long, you can abort the process with <ctrl>-c. You can easily start the update again later.

[[Image:Moodle4Mac_Update2.png|550px]]

  

====Script control ... looking inside ... ====

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor, e.g. TextWrangler.

It is only a text file but it uses a OS X feature to open and execute the script with the Terminal program. You don't need to learn anything ... doubleclick to update everything.

<pre>
#! /bin/sh
#
# This GIT installer for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20140714 - Ralf Krause
#

echo
echo "+--------------------------------------------+"
echo "| GIT updater for your local Moodle server"
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs

if ! test -e moodle28/.git ; then
## the first git update must get everything including .git
git clone --depth 1 -b master git://github.com/moodle/moodle.git moodle28-git
if test -e moodle28 ; then
if test -e moodle28 ; then
if test -e moodle28/config.php ; then
cp moodle28/config.php moodle28-git/.
fi
DATE=`date +%Y%m%d-%H%M`
mv moodle28 moodle28-$DATE
fi
mv moodle28-git moodle28
fi
## the old folder can be deleted now
## if you want to do this please remove '##' from the following line
## sudo rm -R moodle28-*
else
## the next git update only gets the new files
cd moodle28
git pull
cd ..
fi
</pre>

The different versions of the script UpdateMoodle.sh only differ in two parameters ... first we need to know the right folder for Moodle and second we must use the correct git tag for the Moodle version. The shown script upgrades Moodle 2.8.
* Moodle 2.0 uses MOODLE_20_STABLE
* Moodle 2.1 uses MOODLE_21_STABLE
* Moodle 2.2 uses MOODLE_22_STABLE
* Moodle 2.3 uses MOODLE_23_STABLE
* Moodle 2.4 uses MOODLE_24_STABLE
* Moodle 2.5 uses MOODLE_25_STABLE
* Moodle 2.6 uses MOODLE_26_STABLE
* Moodle 2.7 uses MOODLE_27_STABLE
* Moodle 2.8dev uses master

====Install Git====

Download the Git program from http://git-scm.com/download/ ... it's free and open source.

[[Image:Moodle4Mac_Git1.png]]
  

Open the disk image and doubleclick the installer git-xxx-osx.pkg. If you want to know more about Git then read the Git documentation on their web site ... but if you only want to update Moodle the script '''UpdateMoodle.sh''' should also work without reading

[[Image:Moodle4Mac_Git2.png|500px]]
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [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]

[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]
[[es:Paquetes de Instalación Completos para Mac OS X]]

File:Moodle4Mac 8.png

2014-07-21T12:01:49Z

Krause: Krause uploaded a new version of "File:Moodle4Mac 8.png"

File:Moodle4Mac 9.png

2014-07-21T11:52:50Z

Krause:

File:Moodle4Mac 8.png

2014-07-21T11:52:03Z

Krause: Krause uploaded a new version of "File:Moodle4Mac 8.png"

Complete Install Packages for Mac OS X

2014-07-21T11:49:51Z

Krause: /* Connect Moodle from your network ... */

{{Installing Moodle}}
==Summary==
The complete install packages for Mac OS X are named Moodle4Mac and allow a very easy way to install Moodle on your Mac computer (laptop, desktop, server). Moodle4Mac is available from [http://download.moodle.org/macosx/ Moodle packages for Mac OS X]. You will find other downloads for Linux and Window Operating Systems that may involve more customization of configuration files.

Moodle4Mac is based on the software MAMP. MAMP contains everything that is necessary for the operation of Moodle, the Apache web server, MySQL database and PHP scripting language. For the various Moodle versions you can get different installation packages. Please check which Moodle your institution (school, college, university, company) uses on its server so that you can swap your materials between the two platforms easily.

Of course, you can install the latest Moodle development version to find everything about upcoming opportunities and changes. However, please remember that a developer version is not yet a finished product, and that a development version may contain errors.

Moodle4Mac is not intended to be used as a productive server on the Internet. It is only intended for installation on a local computer to test and develop. The configuration is not optimized for security. If you want to run Moodle on an OS X server connected to the internet, please read the instructions [https://docs.moodle.org/en/Step_by_Step_Installation_on_a_Mac_OS_X_Server Step by step installation on a OS X Server].

==System requirements==
+ Apple OS X Computer
+ iMac, Mac mini, MacBook, MacBook Air, Mac Pro
+ Processor: Intel x86_64 (i5, i7, Xeon, Core2Duo)
+ RAM: 4 GB or better
+ Hard Disk: 1 GB free
+ System Software: OS X 10.6, 10.7, 10.8, 10.9

==Download and install ==
'''Step 1:''' Download the disk image '''Moodle4Mac-MAMP.dmg''' from the web site [http://download.moodle.org/macosx/ Moodle packages for Mac OS X] . You will find various image files for the different Moodle versions on this web site.

'''Step 2:''' Double click the disk image '''Moodle4Mac-MAMP.dmg''' to mount the installation disk.

[[Image:Moodle4Mac_1.png|500px]]

'''Step 3:''' Move the folder '''MAMP''' into the folder '''Applications'''. Moodle4Mac is based on MAMP (Mac OS X, Apache, MySQL, PHP). MAMP does not save parameters in a registry or in system variables. If you want to delete Moodle4Mac you only need to move the MAMP folder into the Trash. For more information about MAMP please look at the [http://mamp.info/ MAMP project page].

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

[[Image:Moodle4Mac_2.png|500px]]

'''Step 5:''' Double click the MAMP icon to start the server.

[[Image:Moodle4Mac_3.png|500px]]

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

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

[[Image:Moodle4Mac_4.png|900px]]

==Language packages==

By default Moodle4Mac is delivered in English, any other language must be loaded. The german standard package ''de'' translates all text strings to german, the additional package ''de_du'' adds the informal conversation ''du'', the additional package ''de_kids'' provides scholastic simplifications.

The direct link for the language import is http://localhost:8888/moodle28/admin/tool/langimport/

[[Image:Moodle4Mac_5.png|900px]]

After importing the additional language pack, the settings for the default language for the user account '''admin''' can be switched to German. Only it you change the setting you will find the german menus and german settings dialogs your Moodle. Of course, all text in the text boxes on the home page and in the two preloaded courses Moodle4Mac About and How to update as they were originally entered ... if you like, you can change these texts like ....

==Completely backup your server==
Just as you installed Moodle4Mac the first time on your computer, you can backup a customized system completely. Because all files and configurations are stored within the directory MAMP, you can easily backup your MAMP directory to an external disk. Your Moodle will be frozen together with all settings and all the courses, and it can be recovered at any time in the same form.

First stop all server processes like httpd and mysqld, then exit the MAMP program. After everything stopped you can copy or move the MAMP directory. If you want to transfer MAMP to one or more other computers, you will create a ZIP archive containing the MAMP directory. This ZIP archive can be copied anywhere ... to an USB memory, to a web server, on a burned CD ...

The target computer must be a Mac. On this Mac, unpack the ZIP archive and move the MAMP folder to the Application folder ... done! Everything is going exactly as in section download and installation. In this way you can prepare your Moodle for a presentation or a training lab, and you can distribute it.

[[Image:Moodle4Mac_ZIP.png|500px]]

==Server in your local network==

In various workshops we used Moodle4Mac as a quick server installation for our local network. Make sure that you change the passwords for Moodle and MySQL before you allow access to this server ... otherwise, you'll be amazed how creative your user group can be. Please read the safety instructions of Moodle4Mac.

In this section you will see all required settings to use the server in the local network. Only three steps are required. The first step is to change one line in the config.php for Moodle. In the second step you need to adjust the base address in Moodle. And in your third step you open the firewall for ''httpd''.

To get your Moodle to another computer in your local network your Mac must be clearly addressable. You may use a fixed IP address or a DNS name. In local networks usually ip addresses of the private sections 10.xxx , 172.xxx , or 192.168.xx are assigned. If your Moodle4Mac gets an ip address this address must never change. Please do not use any static ip address if you do not know exactly what you do ... in case of doubt ask the administrator of the local network.

You can't use Moodle4Mac as a local server which is intended to work on different networks.

====Edit config.php====
For the following your computer should be a Mac in a computer lab. For this example it has the the fixed ip address 192.168.0.200. You must edit now the configuration ''/Applications/MAMP/htdocs/moodle24/config.php'' and change the wwwroot from ''localhost'' to ''192.168.0.200''. You must use your own address for your own network!!

After your changes you should get your Moodle with the address http://192.168.0.200/moodle24/

<pre><?php /// Moodle configuration file

unset($CFG);
global $CFG;
$CFG = new stdClass();

$CFG->dbtype = 'mysqli';
$CFG->dblibrary = 'native';
$CFG->dbhost = 'localhost';
$CFG->dbname = 'moodle28';
$CFG->dbuser = 'moodle';
$CFG->dbpass = 'moodle';
$CFG->prefix = 'mdl_';
$CFG->dboptions = array (
'dbpersit' => 0,
'dbport' => '',
'dbsocket' => 1,
);

// localhost wird auf 192.168.0.200 geändert
// $CFG->wwwroot = 'http://localhost:8888/moodle28';
$CFG->wwwroot = 'http://192.168.0.200:8888/moodle28';
$CFG->dataroot = '/Applications/MAMP/data/moodle28';
$CFG->admin = 'admin';

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

require_once(dirname(__FILE__) . '/lib/setup.php');

// There is no php closing tag in this file,
// it is intentional because it prevents trailing whitespace problems!
</pre>

====Replace internal links in Moodle====
The original base address ''localhost'' is stored in many places within the database, your Moodle will not work properly with the modified base address. But images can not be displayed because they are accessible only from their correct address. From your local computer you might not see the problems but if you are outside on a computer getting access to the site.

Moodle has a tool that allows you to replace the database entries from http://localhost:8888/moodle24/ to http://192.168.0.200:8888/moodle28/ .

[[Image:Moodle4Mac_6.png|900px]]

You call this tool via the address http://192.168.0.200:8888/moodle28/admin/tool/replace/

No ... there is no menu option for it, probably because at thoughtless action with this tool also can shred the database ... in the first field enter http://localhost:8888/moodle28/, in the second field http://192.168.0.200:8888/moodle28/ (or the ip address that you have assigned in your installation). Use the correct spelling in both fields! With the hook you acknowledge that you know about the risk ...

====Open the firewall====
The firewall in OS X 10.6, 10.7, 10.8, and 10.9 can be enabled and disabled the ''System Preferences > Security > Firewall''. If the firewall is disabled, although Moodle4Mac works without further settings in the network, but your computer is vulnerable to all requests from the outside ... the latter you should not do!

[[Image:Moodle4Mac_Firewall1.png|520px]]

The the system firewall of OS X is a packet filter that determines for each program if a data packet should be passed or blocked. If the firewall is enabled every program must be entered on a list to respond to requests from outside. Moodle4Mac (or MAMP) uses the httpd program to deliver the sites. You will find httpd in the MAMP folder ... the path is ''/Application/MAMP/Library/bin/httpd''. To enter httpd into the whitelist of the firewall you must click forward on this path ... no idea if there would be a configuration file which you can edit.

You need to get this setting for the firewall only once. If httpd is approved then all computers in your local network can access to Moodle ... by the way it is not important which is used by httpd ... port 8888 or port 80.

Do not open the firewall for mysqld because Moodle itself gets a connection to mysql on the server but no user should communicate with mysql directly from the client.

[[Image:Moodle4Mac_Firewall2.png|520px]]

====Connect Moodle from your local network====
Your web server can be connected with the url http://192.168.0.200:8888/moodle28/ in your local network, where 192.168.0.200 is an example address which your Mac got from the local router. Usually such local numbers start with 10.x.x.x, 172.x.x.x, or 192.168.x.x and you will be able to do your settings even if they differ from this description.

When you got all settings right then all users from any computer in your network will see your Moodle via http://192.168.0.200:8888/moodle28/. And there will be no problem with any operating system.

[[Image:Moodle4Mac_7.png|900px]]

====Connect Moodle from your local network with mobile devices====
The following images show the locale Moodle site with an iPad and an iPhone.

[[image:Moodle4Mac_8.png|890px]]

[[image:Moodle4Mac_9.png|490px]]

==Some words about the security ...==
====MAMP is designed for local computers====
MAMP can be used for testing and developing websites locally on their Apple computers. MAMP should not be used in a production environment because everybody knows all the settings and all the predefined passwords. It's prepared for an easy start and not for a public web server!! But with some careful modfications, you can sufficiently secure MAMP and Moodle4Mac to use them in public development environments.

====How to secure MAMP?====
I found some ideas in the following document: [http://www.network0.org/2006/09/23/how-to-secure-mamp/ How to secure MAMP?]. It's really old and some of the instructions are not correct for the current version.

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 for MAMP Pro on the [http://www.living-e.com/MAMP-PRO/ MAMP internet server]. It's commertial and not free!

====Step by step to secure Moodle4Mac====

  
====Secure connections with HTTPS====
The text is copied from [http://www.webopius.com/content/355/getting-mamp-working-with-ssl-on-os-x webopius web site] (excepted the last steps).

#stop MAMP
#backup your /Applications/MAMP/conf folder
#open a terminal
#enter: ''openssl genrsa -des3 -out server.key 1024''. Enter a password twice.
#enter: ''openssl req -new -key server.key -out server.csr''. Enter the previous password. You need to answer some questions. ''Common name'' expects your local name (for me it was jerome.moodle.local)
#enter: ''openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt''
#enter: ''cp server.key server.tmp''
#enter: ''openssl rsa -in server.tmp -out server.key''. Enter the previous password.
#enter: ''mkdir /Applications/MAMP/conf/ssl''
#enter: cp server.crt /Applications/MAMP/conf/ssl
#enter: cp server.key /Applications/MAMP/conf/ssl
# Edit Applications/MAMP/conf/apache/ssl.conf:
##comment <IfDefine SSL> tag to closing tag (but not the content)
##SSLCertificateFile /Applications/MAMP/conf/ssl/server.crt
##SSLCertificateKeyFile /Applications/MAMP/conf/ssl/server.key
# Edit /Applications/MAMP/conf/apache/httpd.conf:
##Listen 80
##comment <IfDefine SSL> tag to closing tag (but not the content)
# Edit /Application/MAMP/conf/apache/ssl.conf, change the document root (DocumentRoot) for the one you have into /Application/MAMP/conf/apache/httpd.conf
#in a terminal enter: ''cd /Applications/MAMP/bin/apache2/bin''
#enter: ''sudo ./apachectl startssl''
#start MAMP

From now MAMP should start/stop with the SSL support activated. Note that these steps have only be tested with Apache port set to 80 into MAMP preferences.

==How To Update Your Moodle4Mac==
It is very simple to update your locally installed Moodle. You start the update with a double click and everything happens automatically. All courses rest in Moodle. You do not need to renew your local Moodle completely ... you only get the new Moodle files.

====Update the local Moodle via Git====
Make sure that the Git program is installed on your Mac (see instructions below). You also need an Internet connection because the files are downloaded from the Moodle update server. A double click on the icon UpdateMoodle.sh starts the script and updating occurs automatically. That's really all ... could it be easier?

[[Image:Moodle4Mac_Update1.png]]

The Git program connects to the Moodle server and controls which files are new, which have changed and which have been deleted. The transmission time depends on the internet connection. With Git only really necessary files will be transmitted. If the transfer takes too long, you can abort the process with <ctrl>-c. You can easily start the update again later.

[[Image:Moodle4Mac_Update2.png|550px]]

  

====Script control ... looking inside ... ====

If you want to see what is inside the document '''UpdateMoodle.sh''' please feel free to open it with a text editor, e.g. TextWrangler.

It is only a text file but it uses a OS X feature to open and execute the script with the Terminal program. You don't need to learn anything ... doubleclick to update everything.

<pre>
#! /bin/sh
#
# This GIT installer for Mac OS X is part
# of the installation package Moodle4Mac
#
# 20140714 - Ralf Krause
#

echo
echo "+--------------------------------------------+"
echo "| GIT updater for your local Moodle server"
echo "+--------------------------------------------+"
echo

cd /Applications/MAMP/htdocs

if ! test -e moodle28/.git ; then
## the first git update must get everything including .git
git clone --depth 1 -b master git://github.com/moodle/moodle.git moodle28-git
if test -e moodle28 ; then
if test -e moodle28 ; then
if test -e moodle28/config.php ; then
cp moodle28/config.php moodle28-git/.
fi
DATE=`date +%Y%m%d-%H%M`
mv moodle28 moodle28-$DATE
fi
mv moodle28-git moodle28
fi
## the old folder can be deleted now
## if you want to do this please remove '##' from the following line
## sudo rm -R moodle28-*
else
## the next git update only gets the new files
cd moodle28
git pull
cd ..
fi
</pre>

The different versions of the script UpdateMoodle.sh only differ in two parameters ... first we need to know the right folder for Moodle and second we must use the correct git tag for the Moodle version. The shown script upgrades Moodle 2.8.
* Moodle 2.0 uses MOODLE_20_STABLE
* Moodle 2.1 uses MOODLE_21_STABLE
* Moodle 2.2 uses MOODLE_22_STABLE
* Moodle 2.3 uses MOODLE_23_STABLE
* Moodle 2.4 uses MOODLE_24_STABLE
* Moodle 2.5 uses MOODLE_25_STABLE
* Moodle 2.6 uses MOODLE_26_STABLE
* Moodle 2.7 uses MOODLE_27_STABLE
* Moodle 2.8dev uses master

====Install Git====

Download the Git program from http://git-scm.com/download/ ... it's free and open source.

[[Image:Moodle4Mac_Git1.png]]
  

Open the disk image and doubleclick the installer git-xxx-osx.pkg. If you want to know more about Git then read the Git documentation on their web site ... but if you only want to update Moodle the script '''UpdateMoodle.sh''' should also work without reading

[[Image:Moodle4Mac_Git2.png|500px]]
  

==See also==
* [http://mamp.info MAMP = Mac + Apache + MySQL + PHP]
* [http://en.wikipedia.org/wiki/MAMP MAMP in Wikipedia]
* [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]

[[Category:Mac OS X]]

[[de:Vollständiges Installationspaket für Mac OS X]]
[[es:Paquetes de Instalación Completos para Mac OS X]]

File:Moodle4Mac 7.png

2014-07-21T11:40:29Z

Krause: