Mobile web services: Difference between revisions
From MoodleDocs
Helen Foster (talk | contribs) (Mobile app link, small rewording, 2.1 template) |
No edit summary |
||
| (13 intermediate revisions by 3 users not shown) | |||
| Line 1: | Line 1: | ||
{{ | {{Web services}} | ||
Moodle comes with a built-in web service designed for mobile applications. It is required to run the official [[Mobile app]]. Enable it only if you want people to use the official app or if a third party app explicitly requires it. | |||
== Enabling mobile web services == | == Enabling mobile web services == | ||
A site administrator | A site administrator first must enable mobile web services: | ||
In ''Settings > Site administration > Plugins > Web services > External services'' | *In ''Settings > Site administration > Plugins > Web services > External services'' | ||
*Check "Enable mobile web services" and then | |||
*Click Save. | |||
That's it! No other steps required. | That's it! No other steps required. | ||
The rest of this document explains the "behind the scenes". | |||
== What happens when the service is enabled == | |||
Enabling the mobile web services will automatically: | Enabling the mobile web services will automatically: | ||
* enable the web services system (''Settings > Site administration > Advanced features'') | * enable the web services system (''Settings > Site administration > Advanced features'') | ||
* enable the built-in external service called 'Mobile web services' - you should see this new mobile service listed as enabled | * enable the built-in external service called 'Mobile web services' - you should see this new mobile service listed as enabled | ||
* enable the xml-rpc protocol | * enable the xml-rpc protocol | ||
* allow the 'webservice/xmlrpc:use' capability for authenticated user role | * allow the 'webservice/xmlrpc:use' capability for authenticated user role | ||
== Disabling mobile web services == | == Disabling mobile web services == | ||
| Line 28: | Line 29: | ||
** remove the 'webservice/xmlrpc:use' capability for authenticated user role | ** remove the 'webservice/xmlrpc:use' capability for authenticated user role | ||
[[ | ==See also== | ||
* [[Mobile app]] | |||
[[Category:Mobile]] | [[Category:Mobile]] | ||
[[de:Mobile Webservices]] | |||
Latest revision as of 15:53, 13 June 2012
Moodle comes with a built-in web service designed for mobile applications. It is required to run the official Mobile app. Enable it only if you want people to use the official app or if a third party app explicitly requires it.
Enabling mobile web services
A site administrator first must enable mobile web services:
- In Settings > Site administration > Plugins > Web services > External services
- Check "Enable mobile web services" and then
- Click Save.
That's it! No other steps required.
The rest of this document explains the "behind the scenes".
What happens when the service is enabled
Enabling the mobile web services will automatically:
- enable the web services system (Settings > Site administration > Advanced features)
- enable the built-in external service called 'Mobile web services' - you should see this new mobile service listed as enabled
- enable the xml-rpc protocol
- allow the 'webservice/xmlrpc:use' capability for authenticated user role
Disabling mobile web services
When you uncheck 'Enable mobile web services', it will automatically:
- disable the external service called 'Mobile web services'.
- if 'Mobile web services' was the only external service enabled:
- disable the web services system
- disable the xml-rpc protocol
- remove the 'webservice/xmlrpc:use' capability for authenticated user role
