Product support

Get help in the plugin support forum.

  • Added on Oct 3, 2021
  • Current version: 1.0.2
  • Platform Compatibility
    v3.x use latest
    v2.x use latest
    v1.x use latest
  • Extensions: 2
  • Created by



  • Unlimited count of maps with their own configuration.
  • Markers with specific colors, icons, and descriptions.
  • Circles with specific colors and radiuses.
  • Lines, rectangles, polygons can be added with GeoJSON data source.
  • Add data dynamically. For example, automatically change marker color from green to red on weekends.
  • Is possible to use this plugin with different map providers, e.g. with Google Maps, OpenStreetMap.

Use cases

This plugin can be used for showing both static and dynamic data. Several examples of using dynamic features:

  • Show city traffic or transit to know where buses are at the moment.
  • Show city events, parties.
  • Show cafes and restaurants with ratings and reviews.
  • Show shops with their discounts and promotions.
  • Show dangerous places.
  • Show pollution of air, water, ground.

Map providers

This plugin can work with many map providers. Integrations can be added as separate plugins. Current integrations:

  • Google Maps (City Google Maps plugin)
  • Leaflet, OpenStreetMap (City Leaflet Maps plugin)


This plugin is free and open source. Anybody can improve it and add new features or new languages for the backend interfaces. If you have ideas or need features, don't hesitate to send a message.

What is planned:

  • More integrations with the map providers
  • More data sources
  • More options to adjust the view of markers, and other shapes


Please note, this plugin does not contain built-in integrations with the map providers. They should be installed separately. The plugins list is placed in the “Map providers” section.


A map appears on the page in two steps:

  1. Create a map under Backend Menu -> Dynamic Maps -> Maps. There are the basic map configurations and the possibility to choose markers and data sources.

  2. Add the component to the page where the map should appear. The components are provided by the related plugins of Map Providers.


Can add markers and bind them with the specific maps. Markers can have different types.

Regular marker

Single marker in the specified location. Can set marker color, icon, description. An SVG image will have a size of 48x48px on the map. For other formats (e.g. png, jpg, gif) the original size of the image will be applied. The "Color" field is applied only when the "Image" field is empty.

Free icon collections:


The circle is an additional marker type that can help to highlight some areas on the map. Latitude and Longitude are the circle center. The “Color” field is applied for the circle line. The circle is transparent inside.

Data sources

Data sources provide the possibility to add complex and dynamic data to the map.

GeoJSON source

GeoJSON is an open standard format designed for representing simple geographical features, along with their non-spatial attributes. The features include points (therefore addresses and locations), line strings (therefore streets, highways, and boundaries), polygons (countries, provinces, tracts of land), and multi-part collections of these types.

Free online service https://geojson.io can help to draw shapes and export the result as a file (Top Menu -> Save -> GeoJSON).

Custom source

This method is more flexible but requires programming skills. Need to create a PHP class and implement the City\Map\Classes\Source\Custom\SourceInterface interface. The trait City\Map\Classes\Source\Custom\SourceBehavior can be used as the helper. You can check how it works with the sample class City\Map\Classes\Source\Sample\Places

Console commands

The city:map:sample:install command will populate the database with the sample data: maps, markers, data sources.

php artisan city:map:sample:install

The city:map:sample:remove command will remove the sample data (all entities which contain text “Sample data” in the name).

php artisan city:map:sample:remove

Added compatibility with October CMS 3.2

Jan 20, 2023


Add compatibility with October CMS 2.2

Mar 15, 2022


First version of City Dynamic Maps

Oct 01, 2021