Skip to content

Commit 4e88ba7

Browse files
Fix geosolutions-it#11794 Update the configuration and migration guide for map viewer (geosolutions-it#11968)
* Update the configuration and migration guide for map viewer * Fix the migration guide lint issue
1 parent 2712c3a commit 4e88ba7

2 files changed

Lines changed: 70 additions & 2 deletions

File tree

docs/developer-guide/mapstore-migration-guide.md

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -108,6 +108,71 @@ As part of extending the functionalities of the CRS selector, we have deprecated
108108
}
109109
```
110110

111+
### Update containerPosition for the Map and FeatureEditor plugin
112+
113+
The `Map` and `FeatureEditor` plugins require explicit `containerPosition` configuration for proper layout placement. The `Map` plugin renders the map as a background layer, while `FeatureEditor` displays the feature grid in a bottom panel.
114+
115+
**localConfig.json** — Add `containerPosition` to the plugin `cfg` in the `desktop` (and optionally `mobile`/`embedded`) plugins array:
116+
117+
```diff
118+
{
119+
"plugins": {
120+
"desktop": [
121+
...,
122+
{
123+
"name": "Map",
124+
"cfg": {
125+
+ "containerPosition": "background",
126+
"mapOptions": { ... },
127+
"toolsOptions": { ... }
128+
}
129+
},
130+
...
131+
{
132+
"name": "FeatureEditor",
133+
+ "cfg": {
134+
+ "containerPosition": "bottom"
135+
+ }
136+
},
137+
...
138+
]
139+
}
140+
}
141+
```
142+
143+
**pluginsConfig.json** — Add `containerPosition` inside `defaultConfig` for each plugin:
144+
145+
```diff
146+
{
147+
"plugins": [
148+
{
149+
"name": "Map",
150+
"mandatory": true,
151+
"defaultConfig": {
152+
"mapOptions": { ... },
153+
"toolsOptions": { ... },
154+
+ "containerPosition": "background"
155+
}
156+
},
157+
...
158+
{
159+
"name": "FeatureEditor",
160+
"defaultConfig": {
161+
+ "containerPosition": "bottom"
162+
}
163+
},
164+
...
165+
]
166+
}
167+
```
168+
169+
**Reference values:**
170+
171+
| Plugin | containerPosition | Purpose |
172+
|---------------|-------------------|-----------------------------------------------|
173+
| Map | `"background"` | Renders the map as the main background layer |
174+
| FeatureEditor | `"bottom"` | Shows the feature grid in a bottom panel |
175+
111176
## Migration from 2025.01.01 to 2025.02.00
112177

113178
### Update authenticationRules in localConfig.json

web/client/configs/pluginsConfig.json

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,8 @@
2525
"scalebar": {
2626
"container": "#footer-scalebar-container"
2727
}
28-
}
28+
},
29+
"containerPosition": "background"
2930
}
3031
},
3132
{
@@ -82,7 +83,9 @@
8283
"dependencies": ["QueryPanel"],
8384
"children": ["LayerDownload"],
8485
"autoEnableChildren": ["LayerDownload"],
85-
"defaultConfig": {}
86+
"defaultConfig": {
87+
"containerPosition": "bottom"
88+
}
8689
},
8790
{
8891
"name": "TOCItemsSettings",

0 commit comments

Comments
 (0)