Update MIGRATION_GUIDE.md

Author: astroidex

MIGRATION_GUIDE.md

@@ -1,189 +1,3 @@
 # Migration Guide
 
-## Migration to Mapbender 3.3
-
-Check the [Mapbender Update process](https://doc.mapbender.org/en/installation/update.html).
-
-* Make sure you have PHP >= 7.4 or PHP 8.x
-* Provide a backup of your database. 
-* Update your database schema to 3.3 with app/console doctrine:schema:update --force
-* config.yml: Pleas note that in the doctrine connection configuration variables must be set with quotes for example '%database_driver%'
-* CAUTION: Please note that the eye at application is from (3.2.x) used to make the application available for the anonymous user (public access). Before the eye /checkbox at security was used to publish an application.  
-
-To update from 3.2.x to 3.3.x should be quite easy.
-
-If you update from a version < 3.2 you have to follow the steps described at section "Migration to Mapbender 3.2"
-
-### New feature
-
-#### Styling
-
-
-Styling is now possible via variables that can be passed to your application. 
-
-* Mapbender https://github.com/mapbender/mapbender/blob/master/src/Mapbender/CoreBundle/Resources/public/sass/libs/_variables.scss
-* Create your own scss file see for example https://github.com/mapbender/mapbender-workshop/tree/master/src/Workshop/DemoBundle/Resources/public/demo_variables_blue.scss
-* Modify your template - add function getSassVariablesAssets and refer to your scss file see for example https://github.com/mapbender/mapbender-workshop/blob/master/src/Workshop/DemoBundle/Template/DemoFullscreen.php#L23
-
-
-#### Sketch
-
-* Sketch now supports to draw a circle with a defined radius. You draw the circle first and den edit the circle and define a radius.
-* Sketch now allows to define colors to be offered to draw. You can also activate a color picker
-
-
-#### FeatureInfo
-
-* featureInfo Highlight now allows to style the fill and stroke and opacity
-
-
-## Migration to Mapbender 3.2
-
-You can migrate older Mapbender installations to Mapbender 3.2.
-
-Check the [Mapbender Update process](https://doc.mapbender.org/en/installation/update.html).
-
-* Make sure you have PHP >= 7.1.0 and PHP < 8 
-* Provide a backup of your database. 
-* Update your database schema to 3.2 with app/console doctrine:schema:update --force
-* CAUTION: Please note that the eye at application is from (3.2.x) used to make the application available for the anonymous user (public access). Before the eye /checkbox at security was used to publish an application.  
-
-Some elements may not work after the update and  need a closer look.
-
-### Update map_engine_code
-
-If it makes sense update all applications to map_engine_code cureent.
-
-    Update mb_core_application set map_engine_code = 'current';
-
-
-### SearchRouter
-
-You find a demo at https://github.com/mapbender/mapbender-workshop/blob/release/3.2/app/config/applications/mapbender_demo_nrw.yml
-
-1. deprecated empty: use placeholder instead
-
-2. For text and choice you have to define the full class-path.
-
-You also find information at https://github.com/mapbender/mapbender/wiki/Best-practices:-form-types#inversion-of-choices
-
-You can update the configuration with the following SQL.
-
-    Update mb_core_element set configuration =
-    replace(configuration,'s:6:"choice"','s:53:"Symfony\Component\Form\Extension\Core\Type\ChoiceType"')
-        where class = 'Mapbender\CoreBundle\Element\SearchRouter';
-
-    Update mb_core_element set configuration =
-    replace(configuration,'s:4:"text"','s:51:"Symfony\Component\Form\Extension\Core\Type\TextType"')
-    where class = 'Mapbender\CoreBundle\Element\SearchRouter';
-
-    Select configuration from mb_core_element where class = 'Mapbender\CoreBundle\Element\SearchRouter';
-
-
-3. For choice: Please not that key or value are passed flipped that means value and the key- see also https://github.com/mapbender/mapbender/wiki/Best-practices:-form-types#inversion-of-choices
-
-    choices:
-        Bonn - this is the value not the key: Bonn
-        Cologne - this is the value not the key: Cologne
-        Siegburg - this is the value not the key: Siegburg
-
-
-### SimpleSearch
-
-SimpleSearch element was improved. You can now define the projection of the result that comes from the Solr Service. Mapbender will then transform the result to the projection of the map.
-
-SimpleSearch Supports Nominatim, Photon from version 3.2.5 - see workshop demo applications
-
-
-1. Define sourceSrs in your SimpleSearch definition. If not defined the default ('EPSG:4326') be be choosen. You find an example at https://github.com/mapbender/mapbender-workshop/blob/release/3.2/app/config/applications/mapbender_demo_nrw.yml
-
-                     sourceSrs: 'EPSG:25832'
-
-2. query_ws_replace: From version 3.2.8 on set query_ws_replace or modify the code as described in https://github.com/mapbender/mapbender/issues/1391#issuecomment-968645508	     
-
-                     query_ws_replace: +
-
-
- 
-### BaseSourceSwitcher
-
-Please note that on start of an apllication all WMS are activated where the root-Layer is activated.
-
-Before 3.2 it was possible to activate all Basesource and only the first WMS was visible on start.
-
-
-### Template / CSS
-
-CSS change and there will be a big redesign in the backend and frontend in the upcoming versions.
-
-* Check the workshop Bundle for the changes
-* Define your template as desktop-template
-
-
-### Digitizer
-
-Digitizer is available for Mapbender >= 3.2.2. The new Digitizer Version is 1.4. Some functionality is not updated to 1.4 already (f.e. cluster).
-
-* see list of deprecated features https://github.com/mapbender/mapbender-digitizer/releases/tag/1.4
-* see also https://github.com/mapbender/mapbender-digitizer/blob/1.4/Element/Digitizer.php
-* you find a demo in the workshop bundle https://github.com/mapbender/mapbender-workshop/blob/release/3.2/app/config/applications/mapbender_digitize_demo.yml
-* maxResults - is supported again to limit the number of features that are loaded to the application (if not defined all features will be used) (digitizer >=1.4.9)
-* font definitions see https://github.com/mapbender/mapbender/issues/1308
-  - fontSize: 38 definition without px 
-  - labelxOffset: 18 (not supported in 3.2.3)
-  - labelYOffset: 18 (not supported in 3.2.3)
-* types that are not supported in 3.2.4
-  - https://doc.mapbender.org/en/functions/editing/digitizer.html
-  - upload
-  - select with multiselect
-  - coordinates
-* clustering not implemented in 3.2.x
-* style definition is limited not all OL2 styles can be defined
-* Support styling features with icons (interpret externalGraphic, graphicWidth, graphicHeight properties) (Mapbender >=3.2.7)
-* Support data placeholder syntax in externalGraphic (e.g. "/bundles/projectbundle/images/${type}.png") (Mapbender >=3.2.7)
-* Save NULL for empty fields works for int/float/decimal columns but not for double precision (Mapbender >= 3.2.6 https://github.com/mapbender/mapbender/issues/1355)
-* Save NULL for empty fields for text fields does not work. Mapbender saves '' instead (https://github.com/mapbender/mapbender/issues/1385)
-* supports printable: true
-
-
-There is a new style unsaved.
-
-    unsaved:
-        strokeWidth: 3
-        strokeColor: "#f0f0f0"
-        fillColor:   "#ffff"
-        fillOpacity: 0.5
-        pointRadius: 6
-        label: 'Neu - bitte speichern'
-        fontColor: red
-        fontFamily: 'Arial, Courier New, monospace'
-        fontColor: red
-        fontSize: 38
-        fontWeight: bold
-
-
-### WMS Layer visibility
-
-Make sure that your WMS provides a proper extent for all supported EPSG-codes (this is used and saved in table mb_wms_wmslayersource Spalten latlonbounds und boundingboxes). 
-Else it can happen, that a layer is not requested for the given extent of your map.
-
-### Sketch
-
-Redlining was renamed to Sketch (>= 3.2.3)
-
-	Update  public.mb_core_element set class = 'Mapbender\CoreBundle\Element\Sketch',
-	title = 'mb.core.sketch.class.title'
-		where class = 'Mapbender\CoreBundle\Element\Redlining';
-		
-		
-### FeatureInfo
-
-* showOriginal deprecated - parameter not available anymore from 3.2.3
-* highlighting: true - new >= 3.2.3 highlights the geometry if you have WKT integrated in the featureinfo result - see https://github.com/mapbender/mapbender/issues/1287 and also https://wheregroup.com/blog/details/mapbender-featureinfo-mit-highlighting-der-treffer-geometrie/
-
-
-### Print - Print queue
-
-* Mapbender supports print queue
-* see https://wheregroup.com/blog/details/mapbender-druckauftraege-verwalten-und-wiederverwenden-einrichtung-der-warteschleife/
-
+Please note: The Migration Guide moved to the Mapbender documentation https://doc.mapbender.org/en/installation/migration.html.