geostyler/geostyler-geoserver-plugin

GeoStyler UI for the GeoServer

GeoStyler GeoServer extension

This extension integrates the GeoStyler UI into the GeoServer styles tab.

Installation 🥳

To install the extension to your GeoServer just proceed as follows:

1. Download the matching jar from this Nexus repository.
2. Copy the jar into the WEB-INF/lib directory of your GeoServer installation.
3. Restart GeoServer

How to find the matching jar? [click to show/hide]

• The link will lead you to the list of all published artefacts of the plugin, organized in a directory structure
• below org/geoserver/community/gs-geostyler you will find packages for several versions of GeoStyler, e.g. 1.2.0, 1.2.1 or 1.2.2
• Choose the highest version, e.g. 1.2.2, and click on the version. A subfolder will be shown
• You will need to download a version that is compatible to your GeoServer version, e.g. 2.22.2
• The jars are named according to the following scheme: gs-geostyler-[[GeoStyler-version]]-[[GeoServer-version]].jar
• So for the example versions above, the matching jar would be gs-geostyler-1.2.2-2.22.2.jar, since the needed [[GeoStyler-version]] is 1.2.2 and the target [[GeoServer-version]] is 2.22.2

Development 🏗️

Basically the plugin just includes the JavaScript resources of the GeoStyler into a Wicket page which in turn will be rendered by the GeoServer. The lib files aren't part of the repository and need to be packed into the plugin during build. To build the plugin (including the JS sources), just execute:

mvn clean package

This will create a gs-geostyler-<VERSION>-<GEOSERVER_VERSION>.jar file inside the target directory which can be copied to the GeoServer's lib directory. For testing purposes this repository contains a dockerized GeoServer:

1. Copy the freshly created jar into the lib directory:

cp ./target/gs-geostyler-<VERSION>.jar ./docker/geoserver/additional_libs

2. Run GeoServer:

docker-compose up --build --force-recreate --remove-orphans

Release 📰

Uses the @terrestris/maven-semantic-release plugin to create new releases automatically.

Funding & financial sponsorship

Maintenance and further development of this code can be funded through the GeoStyler Open Collective. All contributions and expenses can transparently be reviewed by anyone; you see what we use the donated money for. Thank you for any financial support you give the GeoStyler project 💞

geostyler-geoserver-plugin's Issues

Installation instructions are not clear

On https://github.com/geostyler/geostyler-geoserver-plugin#installation- , the instuctions say:

Download the matching jar from here.

Following that link shows a single package. I guess it is obvious to click through.

Instead of finding the "matching jar", the next page shows maven instructions. On the right are "Assets" - it is not obvious that the required JAR file is here, amongst the 30 files.

In a narrow column, with words wrapping, it is not easy to find the required file. It is better like this:

gs-geostyler-1.1.1-20230313.135501-2-test-sources.jar.md5
gs-geostyler-1.1.1-20230313.135501-2-test-sources.jar.sha1
gs-geostyler-1.1.1-20230313.135501-2-test-sources.jar
gs-geostyler-1.1.1-20230313.135501-2-sources.jar.md5
gs-geostyler-1.1.1-20230313.135501-2-sources.jar.sha1
gs-geostyler-1.1.1-20230313.135501-2-sources.jar
gs-geostyler-1.1.1-20230313.135501-2-tests.jar.md5
gs-geostyler-1.1.1-20230313.135501-2-tests.jar.sha1
gs-geostyler-1.1.1-20230313.135501-2-tests.jar
gs-geostyler-1.1.1-20230313.135501-2.pom.md5
gs-geostyler-1.1.1-20230313.135501-2.pom.sha1
gs-geostyler-1.1.1-20230313.135501-2.pom
gs-geostyler-1.1.1-20230313.135501-2.jar.md5
gs-geostyler-1.1.1-20230313.135501-2.jar.sha1
gs-geostyler-1.1.1-20230313.135501-2.jar
gs-geostyler-1.1.1-20230313.132443-1-test-sources.jar.md5
gs-geostyler-1.1.1-20230313.132443-1-test-sources.jar.sha1
gs-geostyler-1.1.1-20230313.132443-1-test-sources.jar
gs-geostyler-1.1.1-20230313.132443-1-sources.jar.md5
gs-geostyler-1.1.1-20230313.132443-1-sources.jar.sha1
gs-geostyler-1.1.1-20230313.132443-1-sources.jar
gs-geostyler-1.1.1-20230313.132443-1-tests.jar.md5
gs-geostyler-1.1.1-20230313.132443-1-tests.jar.sha1
gs-geostyler-1.1.1-20230313.132443-1-tests.jar
gs-geostyler-1.1.1-20230313.132443-1.pom.md5
gs-geostyler-1.1.1-20230313.132443-1.pom.sha1
gs-geostyler-1.1.1-20230313.132443-1.pom
gs-geostyler-1.1.1-20230313.132443-1.jar.md5
gs-geostyler-1.1.1-20230313.132443-1.jar.sha1
gs-geostyler-1.1.1-20230313.132443-1.jar

There appear to be 2 releases above -1 and -2?

The last file in the list appears to be the required JAR file.

Error when selecting option in "Change filter" menu

It is currently not possible to switch to another filter type (AND, OR etc.). When selecting the respective dropdown menu option in the filter editor (e. g. "Change filter" -> "AND-Filter"), the input fields are replaced with the message "Unknown filter supplied":

---

After trying to switch filter types multiple times by selecting different options in the "Change filter" menu, sometimes another error appears (with error message "TypeError: undefined is not an object (evaluating 't[u].filter')" in console):

---

The Geostyler demo application doesn't show this behaviour, so it seems to me that it is a problem specific to the Geoserver plugin.

When will this plugin be updated to the latest version of GeoStyler and GeoServer?

If I am correct, this plugin uses some 8.x version of GeoStyler, while version 14.x is already released.

GeoStyler assumes the path to start with /geoserver/

Most GeoServer instances might be installed at, for example, http://localhost:8080/geoserver, but some are definitely not, they might be http://localhost:8080/my-path (or mapservice in the bottom screenshot)

GeoStyler installs properly and runs, but on the Style page, hangs with: GeoStyler is loading ...

In DevTools, I can see 2x 404 errors, because GeoStyler is trying to connect to GeoServer on the /geoserver/ path and not on the /my-path/ path.

Before GeoStyler was extracted out of the GeoServer project it worked with a different path. Is there a way to configure GeoStyler now?

Update GeoStyler in GeoServer-Plugin