This is a Cordova mobile app(1) to get notifications of new messages from the Chamilo LMS campus of your choice and review the content from the main course tools.
The finished application should:
- Allow you to connect to one or more Chamilo LMS campuses
- Notify you when you have a new message on the Chamilo LMS campus(es)
- Store your messages locally (but not allow you to answer just yet)
- Review the principal tools for courses and sessions
This is developed as a side project and it might require a few updates to Chamilo itself for the first version to work (web services in Chamilo will have to be extended for it to work(2)).
Clone this repository
git clone git@github.com:chamilo/mobile.git cd mobile Add the platforms
cordova platform add android cordova platform add ios Add the plugins (support-google-services and firebase-messaging are optionals)
cordova plugin add cordova-plugin-file cordova plugin add cordova-support-google-services cordova plugin add cordova-plugin-firebase-messaging Build the application for the platforms added
cordova build android cordoba build ios Execute on an Android device
cordova run android You need configure your project and app in Google's Firebase Console. And download the config files according to the platforms (google-services.json Android and @GoogleService-Info.plist@ for iOS). See the README file for the Google Services plugin.
Edit the config.xml file:
<platform name="android"> <!-- ... --> <resource-file src="google-services.json" target="app/google-services.json" /> </platform> <platform name="ios"> <!-- ... --> <resource-file src="GoogleService-Info.plist" /> </platform>If you'd like to use push notifications (only tested on Android and only available from Chamilo v1.10.4), you will have to enable and set the following parameters in your Chamilo server's:
For Chamilo v1.10.4
//Allow send a push notification when an email are sent //$_configuration['messaging_allow_send_push_notification'] = 'true'; //Project number in the Google Developer Console //$_configuration['messaging_gdc_project_number'] = ''; //Api Key in the Google Developer Console //$_configuration['messaging_gdc_api_key'] = ''; For Chamilo v1.11.x Fill the settings about the Web Services category in Configuration Settings (in administration page)
This development is taken as a side-project, so it might advance slowly at first. Please feel free to send Pull Requests through Github, we will review and include them if we feel they're bringing value.
Coding conventions are not clear at this time as we're mainly PHP developers trying out HTML+JS stuff to generate a mobile app, but we have good grounds with PSR-1 and PSR-2, so we will not accept ugly code, but we will comment on it.