MyTsys Animated Location Map

MyTsys Animated Location Map puts your branches on a map that actually feels alive. Markers drop, pop, ripple, float or sway. Clicking one opens a card with the shop name, address and phone number that you typed in yourself.

Out of the box there is no API key to find: maps are drawn with Leaflet and free OpenStreetMap tiles, so activation to working map takes one click. If you would rather use Google Maps, switch the engine in Map settings and paste your own Google key. A guided panel links each step of getting one, and a Test this key button tells you whether it works before you save.

What you get

• Five marker animations: Drop, Pop, Ripple, Float, Sway

• Twelve pin shapes including a shop front and a mobile phone, each recolourable

• Hover a pin to see the place name without opening the card

• Map presets: save a different look for each page and pick it by name

• Adjustable list text size, with addresses, buttons and spacing scaling to match

• Adjustable split: set how much width the list takes and the map fills the rest

• Search box: visitors type a city or postcode and the list and map narrow to matches

• Route to the nearest shop drawn on the map, with turn by turn directions from the postcode searched

• Use my location: one tap ranks your shops by distance from the visitor

• Browse by area: states or cities listed with the number of shops in each

• Nearby search: a postcode with no exact match is located and your shops are ranked by distance from it

• Six layouts: list left, list right, list floating over the map, cards below the map, list behind a button, or map alone

• Call, Directions, Hours, Book and View details buttons on every location row

• View details links to a page on your site or to any web address

• Optional opening hours and booking link per location

• A details card on every pin with name, address and a tappable phone number

• One-click configuration that loads five sample US locations you can edit or trash

• Two engines you can switch between at any time: OpenStreetMap (keyless) or Google Maps (your key)

• Four keyless map styles, plus Google’s roadmap, terrain, satellite and hybrid

• Colour controls for the pin, the card background and the card text

• Theme colour matching: configuration reads the palette your theme publishes and adopts it

• A shortcode, a block, and an Elementor widget

• An optional address lookup button that fills in coordinates for you

Placing a map

Use the Location Map block, the Elementor widget, or the shortcode:

[mytsys_location_map]

Pages that still use the shortcode from before the rename, [animated_location_map], keep working.

Attributes: preset, engine, animation, pin, color, surface, on_surface, provider, height, view (fit, first, custom), zoom, focus_zoom, lat, lng, ids, layout (split-left, split-right, overlay, stacked, toggle, map-only), search, search_label, nearby, radius, units, geolocate, browse, browse_by, list_size, panel_width, title, subtitle, scroll, limit.

External services

This plugin connects to third-party services. Below is what each one is,

when it is contacted, and what is sent.

Google Maps Platform (optional)

Used only if you set the map engine to “Google Maps” and save your own API

key. When a page containing a map is viewed, the visitor’s browser loads

com and requests map imagery.

This sends the visitor’s IP address, browser user agent, the map area being

viewed, and your API key. Nothing is sent to Google while the default

OpenStreetMap engine is selected, and nothing is sent from the WordPress

admin except when you press “Test this key”.

The API key belongs to you: the plugin never supplies one and cannot create

one on your behalf.

com/maps-platform/terms

com/privacy

OpenStreetMap tiles

Used when the map engine is set to OpenStreetMap and the map style is

“OpenStreetMap standard”. The visitor’s browser requests tile images from

org, sending its IP address, user agent, and the tile

coordinates needed.

org/policies/tiles/

org/wiki/Privacy_Policy

CARTO basemaps

Used when the map style is Voyager, Positron or Dark Matter. The visitor’s

com, sending its IP

address, user agent, and the tile coordinates needed.

com/legal/

com/privacy/

OpenStreetMap Nominatim geocoding

Used in two situations. In both, your server (never the visitor’s browser)

org and receives

back a latitude and longitude.

First, in the admin, to find a location’s coordinates from its address. This

happens when an editor presses “Find coordinates from address”, when a

location is saved with an address but no coordinates, and when the “Look up the missing coordinates” button on the Locations screen

is used.

Second, when a visitor types a city or postcode in the map’s search box and

presses Enter or Search. Your server sends that search term to find out

where it is, so distances to your locations can be measured and the way to

the closest drawn. To steer the answer towards the right country, the

request also carries the area your locations cover and, if you set one,

the country to limit searches to. The visitor’s browser never contacts the service,

and their IP address is never sent to it. This lookup does not run while

someone is typing, and never runs on page load. Results are cached on your

server for a month and shared between visitors, so a repeated search costs

nothing. Turn it off under Map settings if you would rather it never ran.

No visitor data is sent in either case. Each request contains the address,

place name or postcode being looked up, your site’s language, and, as the

Nominatim usage policy requires, a user agent naming this plugin, its version

and your site’s address so the service can identify where requests come from.

Searches are also throttled per visitor and for the whole site.

org/policies/nominatim/

org/wiki/Privacy_Policy

Bundled libraries

4 is bundled in assets/vendor/leaflet/ and served from your own

site. It is released under the BSD 2-Clause licence, included alongside it.