spatial-hub

spatial-hub

Replacement for spatial-portal with Grails, AngularJS and Leaflet.

How to customise

menu-config.json

• The main menu is overridden with /data/spatial-hub/menu-config.json.

  /* Example */
  [
    {
      "name": "Add to map", /* Dropdown menu label */
      "width": 110, /* Dropdown menu button width in pixels. The left hand panel is a fixed width. */
      "items": [ /* Dropdown menu items */
        {
          "name": "Species", /* Button label */
          "open": "ToolAddSpeciesService" /* Open a service based tool. Compatible services are found in grails-app/assets/javascripts/spApp/services/tool*Service.js
        },
        {
          "name": "Area", /* Button label */
          "open": "addArea" /* Open a controller based tool. Compatible controllers are found in grails-app/assets/javascripts/spApp/controller/*Ctrl.js
        },
        {
          "name": "Detailed Area Report (PDF)", /* Button label */
          "open": "AreaReport" /* Open a spatial-service based tool. Available tools are found in spatial-service /admin/capabilities. 
        },
        {
          "name": "Getting Started", /* Button label */
          "open": "https://www.ala.org.au/spatial-portal-help/getting-started" /* Open a https:// or http:// url */
        }
      ]
    },
  

view-config.json

• Templated dialog appearance can be overridden with /data/spatial-hub/view-config.json.

  /* Example */
  {
    "Maxent": { /* Name of tool in spatial-service capabilities */
      "view": [ /* List of input sections in the order to displa */
        {
          "name": "Area to restrict prediction", /* Title of first input section */ 
          "inputs": [ /* List of inputs from tool capabilities for this section */ 
            "area"
          ]
        },
        {
          "name": "MaxEnt options", /* Title of the second input section */
          "inputs": [ /* List of inputs from tool capabilities for this section */
            "testPercentage",
            "resolution"
          ]
        }
      ],
      "input": { /* Override input specifications */
        "testPercentage": { /* Input name */
          "description": "Percentage of records used for testing model?", /* new description */
          "constraints": {
            "default": 0.2 /* New default value */
          }
        }
    }
  }
  

Header and Footer

Configure ala-bootstrap3

• This is recommended since it can be reused by all components that use ala-bootstrap3

  1. Fork commonui-bs3, modify and deploy

  2. Configure to use the deployed commonui-bs3

  # edit /data/spatial-hub/config/spatial-hub-config.properties
  skin.layout=generic
  headerAndFooter.baseURL=<URL to deployed commonui-bs3>
  

Fork spatial-hub, modify and deploy

• Use when development of spatial-hub is expected. It can be used with with the other methods.

Local files

• Adding files local to deployment can add new layouts and resources.

  1. Add a new layout gsp to the /data/spatial-hub/views/layouts directory.

     /data/spatial-hub/views/layouts/myLayout.gsp
     

  2. Additional assets can be added to the /data/spatial-hub/assets directory.

     /data/spatial-hub/assets/css/externalCss.css
     /data/spatial-hub/assets/js/externalJs.js
     /data/spatial-hub/assets/img/externalImage.png
     

  3. Assets can be referenced within the new layout gsp.

     <asset:stylesheet src="css/externalCss.css" />
     <asset:javascript src="js/externalJs.js" />
     <asset:image src="img/externalImg.png" />
     

  4. Change config to use the new layout gsp.

     # edit /data/spatial-hub/config/spatial-hub-config.properties
     skin.layout=myLayout
     

Note:

A forked commonui-bs3 can be deployed to /data/spatial-hub/assets/ and used with the config

# edit /data/spatial-hub/config/spatial-hub-config.properties
skin.layout=generic
headerAndFooter.baseURL=<URL to this spatial-hub instance>/assets

Adding hubs to spatial-hub

Additional map views can be created and served from urls hub/{{hub_name}}. This is done by creating additional files in the /data/spatial-hub directory.

Files required to create a new hub view.

An additional css can be included with /data/spatial-hub/assets/css/{{hub_name}}.css when using skin.layout portal or generic. This may not be used by a local layout gsp file.

Embedding spatial-hub

Example embedExample.html (TODO: finish implementation)