.. include:: /Includes.rst.txt ======= Upgrade ======= If you upgrade EXT:maps2 to a newer version, please read this section carefully! Upgrade to Version 12.0.0 ========================= This version is not compatible with TYPO3 12! Updating TYPO3 extensions using class.ext_update.php has been deprecated since TYPO3 11.0 and was removed in TYPO3 12.0. If you are upgrading from an older maps2 version, first update to at least version 10 and execute the upgrade wizard in the Extension Manager before proceeding. * Added Site Configuration Support * No changes or investigations are needed for integrators. * Changes in EventListeners * For normal users, **nothing has changed**. * However, in **EventListeners**, `PoiCollection` has changed from a **QueryResult** to an **array**. Upgrade to Version 11.0.0 ========================= This version is not TYPO3 11 compatible! Updating TYPO3 extensions with help of `class.ext_update.php` is deprecated since TYPO3 11.0 and was removed with TYPO3 12.0. So, if you upgrade from a very old maps2 version you should upgrade maps2 to at lease version 10.* and execute the upgrade wizard in extensionmanager first. Upgrade to Version 10.0.9 ========================= Somewhere in October 2023 the usage of addresses as path segment in OpenStreetMap Geocoding URIs has been deprecated/removed. Please execute the UpgradeWizard to activate the new parameter based OSM Geocoding URI. This UpgradeWizard will only update that value, if it is the original old URI. Any modified URIs will be kept untouched. Upgrade to Version 10.0.0 ========================= We have added a new Option `defaultMapType` to Extension Settings of `maps2`. Please check, if this value matches your needs and can be found in `LocalConfiguration.php`. Table `tx_maps2_domain_model_poi` has been removed. All POIs will be stored in table `tx_maps2_domain_model_poicollection` now. Please execute UpgradeWizard to migrate existing POI records. Extension Setting and TypoScript setting `allowMapTemplatePath` was completely removed. We have added a new ControllerAction called `OverlayAction`, so please overwrite FluidTemplate Overlay.html instead. All widgets are removed, as TYPO3 11 does not support ViewHelper widgets anymore. We have moved the widget into its own Partial. Please add path to maps2 partial as follows: .. code-block:: typoscript plugin.tx_myext { view { partialRootPaths { ... 5 = EXT:maps2/Resources/Private/Partials/ } } } We have added a new FlashMessage queue identifier `extbase.flashmessages.maps2` for non-controller FlashMessages like in GeoCodeService. Please update your fluid templates and add both ViewHelpers: .. code-block:: typoscript We have changed FlexForm sheet `sDEFAULT` for Plugins `searchwithinradius` and `citymap` to `sDEF`. Please execute UpgradeWizard to move related values to new sheet and remove duplicates. **Only valid for developers:** As we have loaded Extbase ConfigurationManager within Middleware before TSFE it may switch to the BackendConfigurationManager which is completely wrong. To prevent that we have moved MapService::getMapProvider to MapHelper:getMapProvider and deprecated `MapService::getMapProvider`. Please adopt that in your extension. JavaScript files `GoogleMaps2.js` and `OpenStreetMap2.js` have changed. Please update your JavaScript accordingly, if you have overwritten our files. Update to Version 9.3.4 ======================= We have moved all constructor arguments into inject-methods in MapProviderRequestService. We have moved all constructor arguments into inject-methods in AjaxController. So please clear all cache after update. Please use "Flush Cache" in Installtool for TYPO3 10.* to update DI cache. Upgrade to Version 9.0.0 ======================== As Maps2 is TYPO3 10 compatible now we have removed TYPO3 8 compatibility. Please install an old version of maps2, if you still need TYPO3 8 compatibility. On GitHub we have created a new Branch called `TYPO3_8-7`. We have removed Maps2Registry Cache from TYPO3 CachingFramework. So you can remove the Maps2Registry Caching Tables from DB. The cached Maps2Registry configuration will now be saved in typo3conf/Maps2/Registry.json. In case of Composer it will be stored in config/Maps2/Registry.json. As a normal user you only need to clear the caches. If you make use of the Maps2Registry API, please check, if the new json configuration file was created. Further it would be good to check, if the tx_maps2_uid columns still exists in DB. Upgrade to Version 8.0.0 ======================== As a normal user you can update to this version without any problems. We have changed the SignalSlot preIsRecordAllowedToCreatePoiCollection. It does not allow returning $isValid as 4th parameter anymore. As $isValid is a reference now, please change it directly and prevent your SignalSlot to return anything. There is no Debug Output of Map Provider response in Backend anymore, if request fails. We have added more detailed error messages instead. As a Dev, you can access all Messages of Client and GeoCodeService directly. Upgrade to Version 7.0.0 ======================== As a normal user you can update to this version without any problems. As an extension developer who has modified maps2 you should read following lines: We have removed ModifyMarker class. --> Please update lat, lng and radius fields in BE form with JS directly. We have removed modifyMarkerInDb function in our Map Provider JS files for BE modules. --> Please update lat, lng and radius fields in BE form with JS directly. We have removed AjaxController. --> As it was not used since months, it was not used anymore. We have removed all extbase usage from all Ajax classes and have rewritten them completely with Doctrine. --> Please check your extension and check if an update is needed. Update to Version 6.1.0 ======================= As mouseScrollWheelZoom is not available for all map providers you have to execute the Update Wizard to move this Option in FlexForm from Google Maps sheet to MapOptions sheet. Upgrade to Version 6.0.0 ======================== The current CacheIdentifier for InfoWindowContent is not save for multilingual environments. That way we have removed cacheIdentifier property from all Cache ViewHelpers and added the new property poiCollection. It helps us to build a more unique CacheIdentifier with GeneralUtility::stdAuthCode() You have to update all of your templates where our Cache ViewHelpers are used. In most cases only InfoWindowContent.html has to be modified. Please remove cacheIdentifier from all Cache ViewHelpers and add poiCollection instead: Before: ```` After: ```` Please you are interested into Cache ViewHelper properties, please have a look into our updated Documentation. Update to Version 5.1.0 ======================= We have removed the hard-coded map provider settings from VH Widgets and added these to TS-Template. So please check your maps2 output and/or individual JS, if our Widget VHs are still working for you. If you don't make use of our Widget ViewHelpers there should be no problem with this update. Upgrade to Version 5.0.0 ======================== We have added an Open Street Map Implementation. To differ between them we have added two new static templates. One for Google Maps and one for Open Street Map. You have to keep the Default static template, but you have to add one of the other static templates. There is a new Option called `mapProvider` in ExtensionManager. Please set the `mapProvider` and `default mapProvider` to your needs. We have moved some Google Maps fields in FlexForm to another sheet. To prevent duplicates in DB please execute Update Wizard in Installtool. We have removed automatic registering tx_maps2_uid column for tt_address. Please take a look into the example of Maps2 Registry to see how it works. As we have removed our API class GoogleMapsService completely you now have to use the API methods in MapService and GeoCodeService instead. `getPositionsByAddress` returns an ObjectStorage containing Position objects instead of RadiusResult objects now. `getFirstFoundPositionByAddress` return an object of type Position now. Upgrade to Version 4.0.0 ======================== We have added some new fields to maps2. So please go into Extensionmanager and open the configuration. Please check, if everything matches your needs and safe the configuration. You have to clear the system cache, because of new fields in TCA. We have renamed the field ``marker_icon`` from table ``sys_category`` into ``maps2_marker_icons`` and switched to FAL related images. Please execute Update script in Extensionmanager for ``maps2`` to migrate your old images. We have moved all JavaScript Code from ``page.includeJSFooter`` to ``page.includeJSFooterlibs``, so now you have better options to override or append our/your custom JavaScript in TypoScript. All methods of MapService have been migrated into GoogleMapsService. GeocodeUtility have been deleted. Please use getPositionsByAddress or getFirstFoundPositionByAddress of GoogleMapsService. Upgrade to Version 3.0.0 ======================== We have removed TYPO3 6.2 compatibility completely. In f.e. germany it is not allowed to send the users ip address without his confirmation. That's why we have added a new extension management configuration which can output a little form, where the user can accept sending his information to third party servers like Google to display the maps. This new feature touches nearly all methods, so, if you have extended maps2, please pre-check the new widget templates and actions. Maybe it's good to have a look into the new GoogleMapsService class. Update to Version 2.5.0 ======================= With version 2.5.0 we have solved a camelcase problem of the cache table. It was renamed from cf_maps2_cachedHtml to cf_maps2_cachedhtml. Please delete the old tables cf_maps2_cachedHtml and cf_maps2_cachedHtml_tags, deactivate maps2 in extension manager and activate it again. .. important:: It does not help to rename these tables only. Upgrade to Version 2.0.0 ======================== Version 2.0.0 needs a Google Maps JavaScript ApiKey which has to be inserted in maps2 configuration of Extensionmanager (for BE usage) and in constants section of your TypoScript-Template (for FE usage). That's why you have to insert the static template **Maps2 (maps2)** in your TypoScript Template now. Furthermore we have updated the FlexForm of maps2 and removed the option for SwitchableControllerActions. With version 2.1.2 we have added an Update-Wizard in Extensionmanager which can do that job for you. In prior versions you have to remove that setting of each plugin in tt_content record field pi_flexform on your own. .. important:: It does not help to open and save the record in backend!