https://github.com/chamilo/mobile
PhoneGap mobile app
https://github.com/chamilo/mobile
Last synced: 9 months ago
JSON representation
PhoneGap mobile app
- Host: GitHub
- URL: https://github.com/chamilo/mobile
- Owner: chamilo
- License: agpl-3.0
- Created: 2014-09-28T00:00:49.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2022-10-12T04:39:56.000Z (over 3 years ago)
- Last Synced: 2025-07-07T14:46:03.352Z (9 months ago)
- Language: JavaScript
- Homepage:
- Size: 14.2 MB
- Stars: 16
- Watchers: 16
- Forks: 26
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Chamilo LMS mobile app
================================
> 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
Spirit of this project
----------------------
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])).
## Development environment
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
```
### Enable push notification from Chamilo
#### Customizing the app
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](https://github.com/chemerisuk/cordova-support-google-services/blob/master/README.md#installation) file
for the Google Services plugin.
Edit the `config.xml` file:
```xml
```
#### Configuring Chamilo LMS portal
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)
Contributing
------------
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.
[1]: http://beeznest.wordpress.com/2014/09/05/quick-phonegap-setup-on-ubuntu/
[2]: https://support.chamilo.org/issues/7402