Cases of customisations

It is possible to have multiple web applications with custom user interface and showing data for a particular Hub using a single backend server.

Basic steps

• Create and configure the hub in the Collectory-hub
• Configure the web app to show the records of the new hub
• Configure the facet fields
• List of cases of customisation (generic-hub web app)

Basic step

Create and configure the hub in the Collectory-Hub

In the collectory-hub admin interface look for the View all data hubs option, here you can add a new DataHub. Edit the name and any other information you required. In the Members section add the identifier of the Institutions, Collections and Data Resources that belong to the Hub. This is the information that will actually show in the web app.

Configure the web app to show the records of the new hub

Find the UID of the hub you already created in the Collectory-hub admin interface. In the web app config file (grails-app/conf/config.groovy) add the property with the appropiate UID.

biocache.queryContext = "data_hub_uid:dh1"

Configure the facet fields

The config variables starting with facets. are responsible for this:

• facets.include - comma separated list of fields to include (usually only those fields not in the default set as specified by ${biocache.baseUrl}/search/facets)
• facets.exclude - comma separated list of fields to exclude. i.e. fields in the default set you don't want to appear
• facets.hide - comma separated list of field that would be included in the facet column, that you want to be hidden (i.e. un-ticked in the "customise filters" drop down menu). These fields will be displayed if the user changes the default display settings and chooses to turn them on.

Note, you can also change the default set of facets but this is set in the biocache-service application, also via config vars (I think). You may also want to change the way facets are grouped together (see ${biocache.baseUrl}/search/grouped/facets).

List of cases of customisation (generic-hub web app)

To add a case, create a new list item below and link it to a new Markdown file prefixed with 'case-'.

Spain

• List of specific customizations in the Data Portal of GBIF SPain:

1. General customizations:

2. Biocache-hub customizations:

3. Collectory-hub customizations:

France

• List of specific customizations in the Data Portal of GBIF France :

1. General customizations:

• The menu is add in the layout file ; layoutBody : call the other layouts to display the page. In this way, the header et footer layout are the same on all the website.

• add 2 filters to the collectory-hub public page: paleontology and fungi.

Here are the files (on the web-app folder) when the modifications are be made :

https://github.com/gbiffrance/gbiffrance-collectory/blob/master/web-app/css/generic.css#L874 - Lines 874-882

https://github.com/gbiffrance/gbiffrance-collectory/blob/master/web-app/js/map.js#L980 - Lines 980-982