External Applications

The External Applications app is a contrib module for GeoNode. The app is compatible with GeoNode v4.3.x.

The app adds a model ExternalApplication which extends from GeoApp. It integrates as any other resource type so that GeoNode can index, search, and filter an external application like Datasets, Maps, or Dashboards.

Installation and Configuration

To activate the external application app, add the following to the settings.py:

INSTALLED_APPS += ( 'externalapplications', )
EXTERNAL_APPLICATION_MENU_FILTER_AUTOCREATE = os.getenv('EXTERNAL_APPLICATION_MENU_FILTER_AUTOCREATE ', False)

Make sure to add it after the geonode_mapstore_client app as it makes adjustments to the client configuration via the mapstore templates.

Create database migrations and apply them via:

python manage.py makemigrations
python manage.py migrate

Add a Filter Menu

The app adds the resource type externalapplication on which you can apply filter on (either by API or mapstore-client search).

If you want the app to create a quick filter menu entry automatically, set EXTERNAL_APPLICATION_MENU_FILTER_AUTOCREATE=True.

In case you want to manually add such entry use the GeoNode admin. First create a Menu External Application which you put under placeholder TOPBAR_MENU_LEFT. After that, create a MenuItem to create a MenuItem External Application and select the Menu you created. To filter all external applications add the URL /catalogue/#/search/?f=externalapplication.

Working with External Applications

Create an external application by clicking on "External Resource" in the "Add Resource"-Dropdown. Optionally, you can upload a thumbnail. Enable the "External Applications" checkbox under "Filter" to display all external applications only. To jump to the external application, either click on "View" on the resource card or by clicking on "Open external application ..." on the details panel.

Editing an external application can be done only via the admin interface where all attributes can be changed. To update the thumbnail you have to upload the new thumbnail by hand and change the thumbnail URL.

Removing External Application App

Before removing the external application app, you have to delete all external applications from the database. Open the Django shell and execute the following python tasks:

python manage.py shell
from externalapplications.models import ExternalApplication

# Delete all instances from the geonode database
for d in ExternalApplication.objects.all(): d.delete()

After removing all instances, you can revert the mgirations via the managemant command:

python manage.py migrate externalapplications zero

Once, all external applications have been deleted the app can be removed by deleting it from the INSTALLED_APPS in the settings.py.

Funding

This contrib app was funded by

Logo	Funder
	Thünen-Institute
	Leibniz Centre for Agricultural Landscape Research