Installing Joomdle in Moodle 2: Difference between revisions

From Joomdle
Jump to navigationJump to search
← Older editNewer edit →
No edit summary
Line 8: Line 8:
==Configuring Joomdle for Moodle==
==Configuring Joomdle for Moodle==


Once these files have been copied to the moodle/auth/joomdle directory, visit Administration Menu → Notifications to complete plugin installation.
Go to Moodle Authentication section found at  Administration Menu → Plugins → Authentication → Manage  authentication.  You should now see a new option Authentication Plugin called Joomdle, activate this plugin.
 
Then return to the  Moodle Authentication section found at  Administration Menu → Plugins → Authentication → Manage  authentication.  You should now see a new option Authentication Plugin called Joomdle, activate this plugin.


[[Image:moodle2_auth_joomdle_enable1.png|550px|moodle_auth_joomla1.jpg]]
[[Image:moodle2_auth_joomdle_enable1.png|550px|moodle_auth_joomla1.jpg]]


Then configure the plugin by clicking on the "Settings link" and enter your Joomla! server's domain name URL.  This is the only setting that needs to be configured.
Then configure the plugin by clicking on the "Settings link" and enter your Joomla! server's domain name URL.
Remember to add '''http://''' in front of your URL.
Remember to add '''http://''' in front of your URL.


[[Image:r023_moodle_settings_joomdle_authentication_1.jpg|550px|moodle_auth_joomla.jpg]]
[[Image:r023_moodle_settings_joomdle_authentication_1.jpg|550px|moodle_auth_joomla.jpg]]


There is also another option, that you may need to change: Connection method. It chooses which connection method to use when using Joomla's web services. Options are file_get_contents and curl. Select the one available in your server.
There are only 2 more mandatory options to configure:
* Tip: Leave it as default first, and then use System Check page in Joomdle component in Joomla to check which connection method is available in your server.
* Joomdle's Joomla authentication token: enter the token generated in Joomdle configuration in Joomla
* Connection method: select the prefered connection method, that must be available in your server.


To finish the Joomdle Moodle installation, go to Site Administration -> Notifications.
[[File:moodle_basic_settings.png]]


You have now configured the Moodle side of Joomdle.  Proceed to install and configure Joomdle for Joomla!
You have now configured the Moodle side of Joomdle.  Proceed to install and configure Joomdle for Joomla!
Line 28: Line 27:
There are other options you may wish to configure.
There are other options you may wish to configure.


[[File:moodle_js_options.png]]
[[File:moodle_additional_settings.png]]


* Sync users to Joomla: Syncs user creation and removal, and user profile updating.
* Sync users to Joomla: Syncs user creation and removal, and user profile updating.
* Joomla default language: Joomla default languahe string. Only needed for J1.6/1.7 with multi language enabled
* Joomla default language: Joomla default languahe string. Only needed for sites with multi language enabled
* Jomsocial activities: Add Jomsocial activities in response to Moodle events
* Joomla SEF enabled: Joomla SEF setting. Only needed for sites with multi language enabled
* Create Jomsocial groups: Create a Jomsocial group for each course
* Use redirect-less SSO: Use SSO without redirection. Requires cURL
* Delete Jomsocial groups: Delete Jomsocial group when deleting course
* Redirect to Joomla on Moodle logout: Redirect to Joomla home when user logs out of Moodle
* Social activities: Add social activities in response to Moodle events
* Create Social groups: Create a social group for each course
* Delete Social groups: Delete Social group when deleting course
* Auto-sell courses: Create/update/delete courses on Joomla shop when done in Moodle
* Auto-sell courses: Create/update/delete courses on Joomla shop when done in Moodle
* Enrol parents in courses: Auto enrol parents in children courses
* Enrol parents in courses: Auto enrol parents in children courses
* Parent role ID: ID of parent role in Moodle
* Parent role ID: ID of parent role in Moodle
* Give points: Give karma points following Joomla configuration
* Auto mailing lists: Automatically manage mailing lists following Joomla configuration
* Use Joomla user groups: Create Joomla user groups for students and teachers
* Use Kunena forums: Sync course forums to Kunena forums in Joomla


You can also modify the default options for User Profile data locking in Moodle. Locked fields cannot be edited by the user in Moodle, and take the value from Joomla.
You can also modify the default options for User Profile data locking in Moodle. Locked fields cannot be edited by the user in Moodle, and take the value from Joomla.

Revision as of 09:21, 22 December 2014

Languages

[[::Installing Joomdle in Moodle 2|English]]

This document applies to Joomdle Release 2.0.0


Installing Joomdle for Moodle

To allow Moodle to authenticate with Joomla! you will need to install and configure the Joomdle authentication plugin.  This plugin can be found in the Joomdle installation package called auth_joomdle.zip (folder moodle/).

You can directly upload the plugin through Moodle interface, in Site administration->Plugins->Install add-ons


.

Configuring Joomdle for Moodle

Go to Moodle Authentication section found at  Administration Menu → Plugins → Authentication → Manage  authentication.  You should now see a new option Authentication Plugin called Joomdle, activate this plugin.

moodle_auth_joomla1.jpg

Then configure the plugin by clicking on the "Settings link" and enter your Joomla! server's domain name URL. Remember to add http:// in front of your URL.

moodle_auth_joomla.jpg

There are only 2 more mandatory options to configure:

  • Joomdle's Joomla authentication token: enter the token generated in Joomdle configuration in Joomla
  • Connection method: select the prefered connection method, that must be available in your server.

File:Moodle basic settings.png

You have now configured the Moodle side of Joomdle.  Proceed to install and configure Joomdle for Joomla!

There are other options you may wish to configure.

File:Moodle additional settings.png

  • Sync users to Joomla: Syncs user creation and removal, and user profile updating.
  • Joomla default language: Joomla default languahe string. Only needed for sites with multi language enabled
  • Joomla SEF enabled: Joomla SEF setting. Only needed for sites with multi language enabled
  • Use redirect-less SSO: Use SSO without redirection. Requires cURL
  • Redirect to Joomla on Moodle logout: Redirect to Joomla home when user logs out of Moodle
  • Social activities: Add social activities in response to Moodle events
  • Create Social groups: Create a social group for each course
  • Delete Social groups: Delete Social group when deleting course
  • Auto-sell courses: Create/update/delete courses on Joomla shop when done in Moodle
  • Enrol parents in courses: Auto enrol parents in children courses
  • Parent role ID: ID of parent role in Moodle
  • Give points: Give karma points following Joomla configuration
  • Auto mailing lists: Automatically manage mailing lists following Joomla configuration
  • Use Joomla user groups: Create Joomla user groups for students and teachers
  • Use Kunena forums: Sync course forums to Kunena forums in Joomla

You can also modify the default options for User Profile data locking in Moodle. Locked fields cannot be edited by the user in Moodle, and take the value from Joomla.


File:Lock user fields.png


.

Add functions to service

After creating the service, you will be prompted to add functions to it.

File:Addfunctions.png


Search for Joomdle, and add all functions.

Note: Make sure you add all functions that contain Joomdle, even if you need to scroll in the select box.


.

Advanced Moodle Configuration (Optional)

Note:  Some of these options can render your Moodle site inaccessible - please ensure you know what you are doing!

Removing the default Moodle login page (redirect the Moodle login page to Joomla!)

  • Define an alternate login URL for Moodle, so that Moodle users never see the Moodle login page.   We recommend that you don't enable this until everything is up, testing, testing again, tested one more time, and running.  Oh did we say, test first before you do this!
    • Site administration->Plugins->Autenticathion->Manage autenthication: Alternate Login URL.  Here we put Joomla URL.
  • If you are using Moodle in a wrapper, you can use this URL, so Joomla login page won't appear inside the wrapper: http://yoursite.com/components/com_joomdle/views/wrapper/getout_login.php

Creating an alternative login page for Moodle's Administrators

Restrict access to Moodle to registered users only

  • Restrict access to Moodle to registered users only, so that no guests can enter the Moodle site.
    • Security -> Site Policies -> Force users to login
Retrieved from "http://www.joomdle.com/w1k1/index.php?title=Installing_Joomdle_in_Moodle_2&oldid=1769"