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.