ARgomentiamo

Description

ARgomentiamo is a module to publish geolocalized content on the Internet (for its display on the Junaio AR browser) and to accept its modification from this app. ARgomentiamo means "let's discuss" in Italian. This an ongoing project that is initially conceived to display information on active petitions, polls and complaints submitted through the Condiviviamo platform, and accept the user contribution.

Conceived within the Condiviviamo Project developed at the University of Milano-Bicocca and supervised by Federico Cabitza, PhD.

Dependencies

• Geolocation Field
• Prepopulate
• Services
• Token authentication
• Views
• Views Datasource

Other dependencies

• The PHP cURL extension (php_curl): http://php.net/manual/en/book.curl.php
• Junaio - Augmented Reality Browser

Instructions

Installation and Configuration

Junaio

• Install Junaio AR browser on your smartphone/tablet (e.g., Android, iPhone or iPad) from Google Play or App Market
• Signup for free as developer at http://dev.junaio.com/index/signup/user/new

On your Drupal instance

1. Install and enable both the ARgomentiamo and Manage Geolocation Fields modules and their dependecies.
   • Clone the master branch from the git repository to your local file system (git clone git://git.drupal.org/sandbox/iadegesso/2285827.git argomentiamo).
   • Upload the "argomentiamo" folder to your Drupal instance (in <your_instance>/sites/all/modules folder.
   • Enable the new modules.
2. In 'Configuration' (see the attached images), go to the 'Manage ARgomentiamo Settings' page and enter your Junaio username and password
3. In 'Configuration' (see the attached images), go to the 'Add Geolocation Field' page and select the content types to which you want to add geolocation data.
4. In 'Configuration', go to the 'Token authentication' page and add both *argomentiamo-demo* and node/add/* at the end of the 'Activate tokens on specific pages' text area (one per line).
5. Assign to both anonymous user and authenticated user roles the Use token authentication permission.
6. Modify the "argomentiamo" view to adjust the filter on the node content type in order to show only the contents with geolocation data.
7. Finally locate the arel subfolder inside the argomentiamo module folder and edit both the index.html and the index.php files in this subfolder:
   1. Locate the div with the filterOptionsInner class
   2. Inside this div, locate the div with the dropdown class
   3. Use the existing p element as a template to create a an 'Add' button for each content type to which you added geolocation data that you want to add to Drupal directly from the Junaio browser UI.
      E.g., <p><button onclick="getLocation('***CONTENT-TYPE-MACHINE-NAME***')">***LABEL***</button></p> (without '***')

Note

In order to create the Junaio channel of each Drupal user, this user should log off and then log in again.

Usage

Preliminary steps

1. Optional: Within a Drupal instance with the module running, create some content with geolocation data.
2. Login in your Drupal instance and go to the user profile page (see the attached images, e.g., by clicking on the "My Account" link).
3. Open the "ARgomentiamo" tab, and scan the QR code with the Junaio App in order to add the user's channel (click on the Scan command on the topright).
4. Save the channel in the Junaio bookmarks in order to avoid the need to perform a new scan of the QR code every time you want to see the ARgomentiamo contents. To this aim, click on the ARgomentiamo link and then "add to favorites".

POI browsing

1. After that some content with geolocation data has been created either in Drupal or in Junaio (for this latter thing, see below)...
2. ...browse the environment with Junaio within the ARgomentiamo channel to check ARgomentiamo augmented reality.
3. If you click on a POI label, you get a related information page with a link to the Drupal original content.

POI Production while "in the field" (through Junaio)

1. While you are using Junaio within the ARgomentiamo channel, click on Action (on the bottomright) and then "add article".
2. This opens a Web page (within Junaio) on Drupal where a form to create a new (Drupal) content is diplayed.
3. Fill in the form and click on "save"
4. Please mind that you have to have the GPS fix, otherwise the smartphone will not send the geolocalization data that are necessary to create the POI.

Demo

Try ARgomentiamo at http://tinyurl.com/ARgomentiamo-demo