|
|
||
|---|---|---|
| app | ||
| test | ||
| .bowerrc | ||
| .gitignore | ||
| .jshintrc | ||
| .project | ||
| .travis.yml | ||
| bower.json | ||
| build.gradle | ||
| Gruntfile.js | ||
| karma-e2e.conf.js | ||
| karma.conf.js | ||
| package.json | ||
| README.md | ||
Online Demo
Access the online demo version here
Building from source
-
Note: Ensure you have
npminstalled - goto http://nodejs.org/download/ to downloand installer for your OS. -
Clone this repository to your local filesystem (default branch in 'master')
-
To download the dependencies, and be able to build, first install bower & grunt:
npm install -g bower
npm install -g grunt-cli
- Next pull the runtime and build time dependencies by running bower and npm install commands on the project root folder:
bower install
npm install
-
Check the backend server HOST settings in the community-app\app\scripts\modules\configuration.js file. If you are connecting to a non local host, then you may need to change the API_URL_OVERRIDE value to false.
-
Now open the 'index.html' file in FIREFOX browser.
-
Default username/password: mifos/password. This application will hit the demo server by default.
You are done.
Connecting to a MifosX Platform running on a different host:
Out of the box, the UI will connect to the MifosX Platform running on the same host/port because the default value of API_URL_OVERRIDE is set to false in the configuration.js file. If you want to connect to a MifosX Platform running on a different host, e.g. the https://demo.openmf.org running in the cloud, then modify the configuration API_URL_OVERRIDE and HOST in
community-app\app\scripts\modules\configurations.js
as below:
.constant('API_URL_OVERRIDE', 'true')
.constant('HOST','https://demo.openmf.org')
.constant('API_VERSION','/mifosng-provider/api/v1')
Similarly, to connect to a local server running on a different port than the web app on localhost, use:
.constant('API_URL_OVERRIDE', 'true')
.constant('HOST','https://localhost:8443\:8443') // need to escape port number
Later, it may be possible to specify the baseApiUrl as part of the app's URL, watch
Issue 199 (help/pull requests most welcome!).
By default, when the app is running in the local filesystem, it will connect to demo.openmf.org. The UI will connect to the mifosng-provider REST API running on the same host/port when running in the cloud.
If you want to connect to the API running elsewhere, e.g. the https://xyz.org or https://localhost:8443, append the baseApiUrl as a query parameter. Ex:- /index.html?baseApiUrl=https://localhost:8443 /index.html?baseApiUrl=https://xyz.org
Adding dependencies
You can also add more dependencies on bower.json. You can search for them in http://sindresorhus.com/bower-components/ or even:
bower search <package>
Running the tests
Just open test/SpecRunner.html in the browser.
Guidelines for development
- Before sending PR, do code quality check using JSHint
- For adding locale, follow the guidelines given in this wiki (link)