An open API service indexing awesome lists of open source software.

https://github.com/programmfabrik/fylr-plugin-custom-data-type-geonames


https://github.com/programmfabrik/fylr-plugin-custom-data-type-geonames

Last synced: 4 months ago
JSON representation

Awesome Lists containing this project

README

          

> This Plugin / Repo is being maintained by a community of developers.
There is no warranty given or bug fixing guarantee; especially not by
Programmfabrik GmbH. Please use the github issue tracking to report bugs
and self organize bug fixing. Feel free to directly contact the committing
developers.

# fylr-custom-data-type-geonames
Custom Data Type "GEONAMES" for fylr

This is a plugin for [fylr](https://docs.fylr.io/) with Custom Data Type `CustomDataTypeGeonames` for references to entities of the [GeoNames geographical database)]().

The Plugins uses for the autocomplete-suggestions and [GeoNames database]() for additional informations about GeoNames entities. Maps are displayed via the [mapbox-API](https://docs.mapbox.com/api/).

## installation

The latest version of this plugin can be found [here](https://github.com/programmfabrik/fylr-plugin-custom-data-type-geonames/releases/latest/download/customDataTypeGeonames.zip).

The ZIP can be downloaded and installed using the plugin manager, or used directly (recommended).

Github has an overview page to get a list of [all releases](https://github.com/programmfabrik/fylr-plugin-custom-data-type-geonames/releases/).

Check in your fylr.yml that you do not have a conflicting plugin enabled: remove the line with easydb-custom-data-type-geonames.
In the file fylr.yml in yaml hierarchy:
```
fylr+:
plugin:
paths:
- "/fylr/files/plugins/easydb/easydb-custom-data-type-geonames"
```
... just remove this one line and restart fylr.

## requirements
This plugin requires https://github.com/programmfabrik/fylr-plugin-commons-library. In order to use this Plugin, you need to add the [commons-library-plugin](https://github.com/programmfabrik/fylr-plugin-commons-library) to your pluginmanager.

## configuration

In `manifest.yml` you can configure:

* `schema-options`:
* which [featureclasses] () are offered for search.
* if a mapbox-token is added, the plugin shows geonames-places in a static map.
* if a valid geonames-username is given, fulltext will be available

* `mask-options`:
* wether to show a dropdown with available featureclasses (place-categorie) or not
* wether to show a dropdown with available featurecodes (place-type) or not
* default country for the country-dropdown (2 digits-code)
* default value for search expansion (Records of the lowest administrative level ("admin4") are also found via the higher-level administrative unit ("admin3"))
* wether the ancestors are shown in hitlist
* editordisplay: default or condensed (oneline)

* `base-config`:
* "days"
* "default_language"
* "geonames_username"

## saved data

* conceptName
* Preferred label of the linked record
* conceptURI
* URI to linked record
* conceptFulltext
* fulltext-string which contains: geonameId, adminName1, adminName2, adminName3, adminName4, adminName5, countryName, toponymName, alternateNames
* conceptAncestors
* the parent hierarchy of the selected record
* conceptGeoJSON
* point or polygon as geoJSON
* frontendLanguage
* the frontendlanguage of the entering user
* facetTerm
* custom facets, which support multilingual facetting
* _fulltext
* easydb-fulltext
* _standard
* easydb-standard
* geo

## updater

Note: The automatic nightly updater can be configured. Make sure to also activate the corresponding fylr service.

## sources

The source code of this plugin is managed in a git repository at .