Preparing Moodle
This article describes the procedure for preparing Moodle prior to installing Joomdle.
Moodle Web Services
Start by logging on to your Moodle site with an admin account.
- Go to Site administration > Plugins > Web Services > Overview.
- Click Enable Web Services, and tick the checkbox.
- Go to Site administration > Plugins > Web Services > Manage Protocols.
- Enable the XML-RPC protocol.
Moodle User
Joomdle needs a Moodle user account, with the right level of access permissions. This user account should only be used by Joomdle, and should not be the main admin account.
- Go to Site administration > Users > Accounts > Add a new user.
- Enter Name: Joomdle Connector
- Username: jconnect
- Document the password.
Now we have a Joomdle user account, we can check the Permissions.
- Go to Site administration > Users > Permissions > Check system permissions.
- Select the newly created Joomdle user account.
- Click Show this user's permissions.
- Filter for XML.
- Note the status of the Web service: XML-RPC protocol permission.
It will likely be not allowed, so we will create a role that allows this permission, and give our Joomdle user account the role.
- Go to Site administration > Users > Permissions > Define Roles.
- Click the Add a new role button.
- Use role or archetype: No role.
- Short name: XMLRPC
- Full name: Allow access to web service XML-RPC.
- Context: System.
- Allow the following permissions, and click Create this role.
Use XML-RPC Protocol
View discussions
Now we can assign the Joomdle user account to this role.
- Go to Site administration > Users > Permissions > Assign system roles.
- Select the newly created Role.
- Add the Joomdle user account.
Now you can check the permissions again, and you should see the two permissions enabled.
Add a Moodle Service
Now we can add a new Moodle service so that we can define what the Joomdle user account can do in Moodle.
- Go to Site administration > Plugins > Web services > External services.
- Click Add to create a new service.
- Name: Joomdle Web Service.
- Short name: Joomdle.
- Select Enabled and Authorised users only.
Note that we will be adding functions to this service later on.
Now we can add the Joomdle user account as an authorised user.
- Go to Site administration > Plugins > Web services > External services.
- Click Authorised users, for the newly created service.
- Add the jconnect user account.
Create a Token
The final step in preparing Moodle for a Joomdle installation, is to create a token.
- Go to Site administration > Plugins > Web services > Manage tokens.
- Click Add.
- User: Select the jconnect user account.
- Service: Select the Joomdle Service.
- Click Save changes.
You will now see a long alpha-numeric token that will be needed in Joomdle's configuration in Joomla.
Frame embedding
You will need to allow frame embedding, if you want to use a Joomdle wrapper
- Go to Site administration > Security > HTTP security.
- Enable the option to Allow frame embedding.
Thanks for visiting.