Ushahidi online-offline Reporting Web Application
------------------------------------------------

    https://sites.google.com/site/onlineofflinewebapps/ushahidi-webapp

How to start
------------

  Build the project:

    $ cd /opt/
    $ git clone git://github.com/axaroth/ushahidi-webapp.git oo-report
    $ cd oo-report
    $ python2.6 bootstrap.py

      In buildout.cfg to edit the [static-config] server_port parameter, default
      is port 8080.

    $ ./bin/buildout

  Start the http server:

    $ ./bin/serve-static

  Rules for Apache:

    You must have the mod_proxy enabled

    RewriteEngine On
    RewriteRule ^/oo-report/(.*) http://127.0.0.1:8080/$1 [P,L]
    <Directory /var/www>
        Options Indexes FollowSymLinks MultiViews
        AllowOverride All
        Order allow,deny
        Allow from all
    </Directory>

  Note

    In this configuration ushahidi responds on an URL as:

      http://myushahidi.org/

    and the web app on:

      http://myushahidi.org/oo-report/

    otherwise you need to modify the rule according and fix the constant in the
    javascript file /opt/oo-report/www/resources/interview.db.js:

      var api_url = "/api"  // fix for your server


What we used
------------

    Development http server

        zc.buildout, Paste and PasteScript (and other Python libraries)

    WebApp

        jQuery JavaScript Library v1.5
            http://jquery.com/

        jQuey Mobile 1.0a3
            http://jquerymobile.com/

        geo-location-javascript v0.4.3
            http://code.google.com/p/geo-location-javascript/

        persistence.js
            http://persistencejs.org/

How it works
------------

    default.ini

        Configuration for 'paste serve' script (simple http server)

    ushahidi.reporting.webapp

        Provides the html5 manifest generation and a fake Ushahidi API
        for testing purpose.

    index.html

        This page contains the html to render the interfaces and loads
        the application code and libraries.

    interview.db.js

        Setup the DB and provides the functions to manage the collected
        data.

    interview.mobile.js

        It contains the code that manages the user interfaces and the
        actions on the forms.


NOTE: How 'upload picture' works

    - data store
    1. get the file (fs path) from the form
    2. transform the file in base64 encoding

    - data send
    1. get the base64 encoding from DB
    2. create a blob from the enconding using blob builder: https://developer.mozilla.org/en/DOM/BlobBuilder
    3. create the FormData object and append the blobfile)

    options:
        4. send the FormData object using XMLHttpRequest: http://www.html5rocks.com/en/tutorials/forms/html5forms/#toc-form-data-object
        4. send the FormData object using $.ajax:http://stackoverflow.com/questions/5392344/sending-multipart-formdata-with-jquery-ajax