.. include:: /Includes.rst.txt

.. _breaking-changes:

================
Breaking Changes
================

17. February 2023
=================

Remove allowed on standard page
-------------------------------
Records of attributes and locations are not allowed on standard pages anymore.


29. August 2022
===============

The import command is refactored and the arguments and options are cleaned up. Please read the :ref:`docs <importCommand>` for the changes


15. February 2021
=================

Rename property
---------------
Rename content to contentElement in location model


01. Mai 2020
============

Refactor signal slots to PSR-14 events
--------------------------------------
All slots are replaced with events
Evoweb\StoreFinder\Controller\MapController mapActionWithConstraint with MapGetLocationsByConstraintsEvent


03. October 2019
================

Drop migration wizard
---------------------
Dropped support of LocationMigrationWizard. It's now more then three years that locator is not really supported
anymore. Who every wants to migrate locations should use version 3.x and upgrade afterwards.

Change geocoding
----------------
Change to use geocoder-php/geocoder for geocoding locations. By this a hole spectrum of `providers/geocoders <https://github.com/geocoder-php/Geocoder#world>`_
are available now

Migration steps
---------------
Please check the extension configuration whether the api key assignment still works


31. January 2019
================
Drop already deprecated GeocodeLocationsTask in favor of GeocodeLocationsCommandController

Deprecate GeocodeLocationsCommandController to be replaced with GeocodeLocationsCommand once support for
TYPO3 8.7 gets dropped.


18. May 2019
============
As of now configuration.insertSingleViewInto is deprecated and removed.

Please use configuration.renderSingleViewCallback instead. This should contain a callback function
which renders the single view element. As parameter location and infoWindowTemplate are available.
In addition a configuration.handleCloseButtonCallback should be provided.

Example:

.. code-block:: javascript
   :caption: EXT:my_extension/Resources/Public/JavaScript/map.js

   configuration.renderSingleViewCallback = function (location, infoWindowTemplate) {
         location['information']['staticMapCenter'] = encodeURIComponent(location.information.address) + ',+'
            + encodeURIComponent(location.information.zipcode) + ',+'
            + encodeURIComponent(location.information.city) + ',+'
            + encodeURIComponent(location.information.country);

         html = infoWindowTemplate.render(location.information);

         var $singleView = $('.yourSingleView');
         if ($singleView.hasClass('show')) {
            $singleView.hide();
            $singleView.removeClass('show');
         }
         $singleView.html(html);
         $singleView.show();
         $singleView.addClass('show');

         $('body').trigger('initializeTabs');
   };

   configuration.handleCloseButtonCallback = function (button) {
         var $singleView = button.parents('.yourSingleView');
         $singleView.hide();
         $singleView.removeClass('show');
   }


10. January 2019
================
As of the location model does not escapeJsonString any properties anymore. With this getNameRaw and
getCityRaw are dropped.

Migration steps
---------------
Check for {location.nameRaw} and {location.cityRaw} and replace it with
{location.nameRaw -> f:format.json()} and {location.cityRaw -> f:format.json()}

All {location.* -> f:format.json()} usage may not be wrapped in " or '. If present remove those.