README.md

HXLDash

A dashboarding tool to build quick visualisation utilising the power of the Humanitarian Exchange Lanaguage (HXL)

https://hxldash.com/

Install

Built using Python 2.7

Install django

pip install django

Install database connector. For postgresql

pip install psycopg2

Install cookie banner

pip install django-cookie-law Full instructions for install here: https://github.com/TyMaszWeb/django-cookie-law

Change database settings in settings.py for your database

Create a copy of the settings.py template and rename as settings.py. Change the database settings to connect to your database.

Example set up: https://www.digitalocean.com/community/tutorials/how-to-use-postgresql-with-your-django-application-on-ubuntu-14-04

To run the test server

python manage.py runserver

To populate the database with test data

python manage.py populate_database

HXL Proxy

The default version uses the public version of the HXL proxy hosted at https://proxy.hxlstandard.org/data/source. Files used with HXL Proxy will have to be exposed to the web.

If you are installing a private instance of HXLDash you will also need a private instance of HXL Proxy (https://github.com/HXLStandard/hxl-proxy) accessible to HXLDash.

The following lines of code would have to changed for the new server address: https://github.com/SimonbJohnson/quickX3/blob/master/hxldash/static/js/dashmaker.js#L3

https://github.com/SimonbJohnson/quickX3/blob/master/hxldash/static/js/dashview.js#L46

These is a issue to parameterise this into the settings file: #55