View source for Moodle Mobile additional features

{{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]]