Note: You are currently viewing documentation for Moodle 3.3. Up-to-date documentation for the latest stable version of Moodle is probably available here: Mobile web services.

Mobile web services

From MoodleDocs
Revision as of 17:47, 31 October 2011 by Helen Foster (talk | contribs) (moved Enable mobile web services to Mobile web services: shorter title)

Template:Moodle 2.1Moodle 2.1 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.

What happens after 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

The rest of this document explains "behind the scenes" for any further mobile service customization.

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

See also