In order to create a context, the Admin can click on the New Context button in the Contexts page and he will be addressed directly to a wizard. The wizard is composed by the following three steps:
You can move through the steps of the wizard with the dedicated buttons located at the bottom right of the page.
In this way the admin can:
Move forward on the different steps through the Next button
Go back to the previous step through the Back button
Closed the context wizard through the Close button
This first step allows to configure the Name and the Window title of the new context.
The name and the window title are both mandatory fields. Note that it is not allowed to choose a name that has already been assigned to another MapStore's resource (like maps, dashboards, stories): a warning message appears in this case to notify the user.
The Window title is the name of the browser window.
To create the context viewer, the map configuration (like the one described here opens so that the admin can set the initial state of the context map.
In particular the admin can configure the context map using the following MapStore tools:
Catalog, present in Burger Menu , to configure the supported remote services (like CSW, TMS, WMS and WMTS) and add layers to the map.
Import, present in Burger Menu , to import map files and import vector file.
Annotations, present in Burger Menu button, to add annotations to the map.
Table of Contents, through the button where the admin can use all the available functionalities to manage context layers.
Background Selector, at the bottom left of the viewer, allows the user to add, manage and remove map backgrounds
CRS Selector, through the button at the bottom right of the Footer, to switch the Coordinate Reference System of the map
The Side Bar, at the bottom right of the viewer, is useful to the admin to explore the map.
An example of a context viewer with a new background and a layer, added to the map, can be the following:
This wizard step allows to select the extensions that will be available in the context viewer: the user of a context will use only the plugins enabled by the administrator. Within this wizard step, all the available plugins in MapStore are present in the left side list ready to be selected for the context . The right side list contains the list of plugins selected by the administrator for the context.
Through the central vertical bar the administrator can select the plugins to include in the context viewer by moving them from the Available Plugins list to the Enabled Plugins list.
In particular, the admin can:
- Add an extension from the Available Plugins list to the Enabled Plugins list, using the Add Extension button . Instead, remove an extension from the Enabled Plugins list using the Remove Extension button , as follows:
- Bring all extensions from one list to another using the Add all extensions button or remove all extensions using the Remove all extensions button , as follows:
To search for an extension listed, the admin can use the Search bar.
Add extensions to MapStore
The MapStore administrator can also install a custom plugin by using the Add extension to MapStore button , at the top right of the Available Plugins list.
Here the admin, in order to upload the plugin's package, can drag and drop it inside the import screen or select it from the folders of the local machine through the button.
A plugins package must be provided as .zip archives that contains:
index.jsonfile with a plugin definition
A plugin file with the extension code in
All mandatory translations files in MapStore.
A sample extension for testing purposes is available here. More extensions will be available in the future versions of MapStore.
Through the Add button the plugin is inserted in the Available Plugins list.
A plugin so installed can be included in the context viewer by moving it in the Enabled Plugins list or uninstalled through the Delete button .
Optional tools for enabled plugins
In the Enabled Plugins list, the following buttons are displayed for each extension:
- The Enable selection of current plugin for user button allows the admin to configure which extensions will be present in the Extension Library and not activated by default.
Once a plugin has been included in a context, it is active by default and available inside the viewer. The administrator can click on Enable loading this plugin on startup button to make that plugin not active by default: clicking on this button the plugin will not be available in the context viewer until explicitly activated by the end user through the Extension Library.
- The Edit Plugin Configuration button allows the admin to interact with a text area to specify the plugin configuration and to override the default one.
- The Open plugin configuration documentation button opens the Plugins Documentation in another page.