Skip to content

AtlasOfLivingAustralia/biocache-hubs

Repository files navigation

biocache-hubs Build Status

biocache-hubs is a Grails plugin that provides the core functionality for the Atlas of Living Australia (ALA) Occurrence search portal (Biocache) front-end.

This application/plugin provides a web UI for a back-end service called biocache-service (see biocache-service API) - a full-text search and record retreival for occurrence data records, using JSON data format.

An example Grails application that uses this plugin, is the generic-hub app. There are other implementations listed in the ALA Github repository (all implementations have a suffix '-hub').

Versions

The grails2 branch contains the 1.5.x series of the plugin compatible with Grails 2.x.

The master branch hosts version 2.x and forward of the plugin compatible with grails 3.x.

Data Quality project version is 4.x (see https://www.ala.org.au/data-quality-project/).

Getting started

The easiest way to get started is to clone the generic-hub project and then modify it to suit your needs. Any functionality that you wish to alter, is achieved by creating a copy of the groovy/GSP/JS/CSS/i18n file of interest, from biocache-hubs and placing it in your client app, so that it overrides the plugin version.

E.g. to change the header and footer, create a copy of the file grails-app/views/layout/generic.gsp (calling it acme.gsp) and then edit the configuration file to point to this new GSP file: grails-app/conf/Config.groovy - change skin.layout = 'generic' to the new layout file, e.g. skin.layout = 'acme'.

To load and view you own occurrence record data, you'll need to install and run biocache-store and biocache-service and then configure your app to use your local biocache-service by adding/editing the line: biocache.baseUrl = "https://hostname.acme.org/biocache-service/".

A full list of the configuration settings (and their default values) are found in src/main/groovy/au/org/ala/biocache/hubs/defaultConfig.groovy.

Grails 3

Starting with version 1.7 biocache-hubs has been migrated to run on Grails 3 and Java 8

If you have deployed biocache-hubs plugin version 1.4.x or earlier in your own hub then you need to follow the following points to bring that hub up to date to use the latest version of biocache-hubs