Download the PHP package heimrichhannot/contao-google-maps-bundle without Composer
On this page you can find all versions of the php package heimrichhannot/contao-google-maps-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download heimrichhannot/contao-google-maps-bundle
More information about heimrichhannot/contao-google-maps-bundle
Files in heimrichhannot/contao-google-maps-bundle
Package contao-google-maps-bundle
Short Description This bundle adds google maps integration to Contao.
License LGPL-3.0-or-later
Informations about the package contao-google-maps-bundle
Contao Google Maps Bundle
This bundle adds google maps integration to Contao. It's based on ivory/google-map.
Features
- introduces a simple Contao backend entity to configure your Google Map and overlays (markers, info windows, ...)
- frontend module and content element
- insert tag and twig function
- easy contao command based migration tool for delahaye/dlh_googlemaps (courtesy to delahaye!)
- responsive support (mobile first), provide responsive configurations that will update the map upon reaching the value (greater than breakpoint)
- support for List bundle and Reader bundle
- support for hofff/contao-consent-bridge
Setup and usage
Setup
-
Install with contao manager or composer and update database afterwards
composer require heimrichhannot/contao-google-maps-bundle
- Optional: If you have already google maps created with delahaye/dlh_googlemaps refer to the section "Migrating from dlh_googlemaps".
- Set your Google API key (capable of Google Maps and Google Static Maps) if not already done in one of the following places (ascending priority):
- global Contao settings (
tl_settings
) - page root (
tl_page
) - Google Maps config (
tl_google_map
)
- global Contao settings (
Usage
- Create a Google Map using the corresponding menu entry in Contao on the left.
- Optional: create markers with the created google map configuration (markers are child entities of a map)
- Now you can integrate the map in your website using one of the following build-in ways:
- Content element
- Module
- Insert tag (see below)
- Twig function (see below)
- render a list as map, list config element or reader config element
List and reader bundle
For both list and reader bundle a config element is provided to add maps to the items.
For lists you also get the option to render the complete list as map.
In your list configuration, check the renderItemsAsMap
option and do the additional configuration.
You can use or adapt the bundled default template: list_google_maps_default.html.twig
and list_item_google_maps_default.html.twig
.
Typical, your list items don't have the correct fields added and filled to be used as markers on a maps.
So you need to implement an event listener for the GoogleMapsPrepareExternalItemEvent
and create or update an overlay object that can be displayed on the map.
Migrating from dlh_googlemaps
Although we cannot guarantee to fully migrate your existing dlh_googlemaps instances, you will nevertheless have a point to start from. Think of it as a 95% migration ;-)
Migrating is as simple as running vendor/bin/contao-console huh:google-maps:migrate-dlh
from your contao root dir. Your dlh google maps are not changed by this process, only new instances in tl_google_map
and tl_google_map_overlay
are created out of the existing legacy data.
Insert Tags
Name | Arguments | Example |
---|---|---|
google_map | ID of the tl_google_map instance |
{{google_map::1}} |
google_map_html | ID of the tl_google_map instance |
{{google_map_html::1}} |
google_map_css | ID of the tl_google_map instance |
{{google_map_css::1}} |
google_map_js | ID of the tl_google_map instance |
{{google_map_js::1}} |
Twig functions
Name | Arguments | Example |
---|---|---|
google_map | ID of the tl_google_map instance |
{{ google_map(1) }} |
google_map_html | ID of the tl_google_map instance |
{{ google_map_html(1) }} |
google_map_css | ID of the tl_google_map instance |
{{ google_map_css(1) }} |
google_map_js | ID of the tl_google_map instance |
{{ google_map_js(1) }} |
TODO
- Overlay types:
- polyline
- circle
- rectangle
- ground_overlay
Documentation
Developer documentation
All versions of contao-google-maps-bundle with dependencies
contao/core-bundle Version ^4.9
doctrine/dbal Version ^2.11 || ^3.0
heimrichhannot/contao-twig-support-bundle Version ^0.2.16 || ^1.0
heimrichhannot/contao-utils-bundle Version ^2.213
ivory/google-map Version ^3.0 || ^5.0 || ^6.0
mvo/contao-group-widget Version ^1.4
symfony/config Version ^4.4 || ^5.0
symfony/console Version ^4.4 || ^5.0
symfony/dependency-injection Version ^4.4 || ^5.0
symfony/event-dispatcher Version ^4.4 || ^5.0
symfony/http-foundation Version ^4.4 || ^5.0
symfony/http-kernel Version ^4.4 || ^5.0
twig/twig Version ^1.38.1 || ^2.7.1 || ^3.0